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1. INTRODUCTION 

1.1 Purpose of This Manual 

This manual »iU provide the ^formation needed by^ 
programmer to coBpilo and «- ute » ^f J9«er that will 
provides a de taxied drscussron of | M(i executi on of a 
be produced as a result or rut- r nuide to the HAL/s 
BSL/S program .«- -uual rs not a guifl.^ ^ ^ ^ ^ 

language. ".'= ""!' Ju/s proqia.s compiled ana debugged on 
^ P tS«/«o a* knowledge of P the HAL/S^ language syntax and 
^rogram^g technics 1! presumed in some of the drscussrons 

1.2 Scope of This Manual 

The succeeding sections of this aocu.ent £££* J »j£% 
guide for all Phases in the development of a succe^ful^^ ^ 
program. Topics range from operatrng sysre onpreS3 „ t3 

k?u?r^ i0n thf H^S^Progra^fng S,-EV have specific 
System/360 dependencies. 
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2. RUNNING A HAL/S PROGRAM 



2.1 Communication with OS/360 - Job Control Language 

2.1.1 Introduction 

All communication between the programmer and the 
operating system of the host computer must be done through 
Job Control Language (JCL) . This section will present the 
basic JCL that must be provided to invoke HAL/S. A 
detailed discussion of JCL is not attempted. The intent 
is to give first-time and average users sufficient 
information to begin running. A more detailed description 
of the HAL/S JCL is available in Appendix C. That 
description is written for persons experienced in handling 
JCL and therefore does not "teach" the use of JCL. 

2.1.2 The Catalogued Procedure 

Because JCL is a complex language, the operating 
system (OS/360) allows for the grouping and saving of 
whole blocks of JCL. Such a saved block of JCL is known 
as a catalogued procedure. When this facility is used, 
the programmer need only submit a minimum of his own JCL 
to make a run. The descriptions that follow presume the 
existance of a catalogued procedure that will compile, 
load, and execute a HAL/S program. A listing of a 
prototype catalogued procedure (HALSCLG) is presented in 
Appendix C. Any JCL modifications that are desired may be 
made in the standard manner described in the IBM 



publication: 



IBM System/360 Operating System: 
job Control Language Dser s Guide 
Order #GC28-6703 



The user calls in the catalogued procedure by referencing 
it by name on an EXEC card as follows: ■■;■<• 

//A'VXHAHE EXEC HALSCLG 

This card is sufficient to call in the catalogued JCL and 
begin execution of the steps in the compilation process. 
If no other information is supplied on this EXEC card, all 
options available to the programmer for specifications 
will default to that set of options saved in the 
catalogued procedure. The user may change or add to these 
options by specifying more information on the EXEC card. 
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2.1.3 The Optional Parameters: OPTION and RDNPARM 

The HAL/S compiler has various options that the user 
may specify through JCL. These options invoke funcitons 
in both the compilation and execution steps of a HAL/b 
iob. The catalogued procedure HALSCLG allows the 
specification of these options with any of the keyword 
parameters OPTION or RUNPARH. These parameters are code 
on the EXEC card as follows: 

//ANYNAME EXEC HALSCLG, OPTION=» ?? • ,RONPARH=« ??« 

The. OPTION parameter is put into the PARM field of the 
compilation step and is available to the compiler for 
interpretation and action (valid options are listed in 
appendix A). The RUNPARM parameter is similarly made 
available to the HAL/S execution-time monitoring system, 

2.1.4 Specifying the Source Language Input 

The user must identify, through JCL, the location of 
the source program that he wants compiled. The typical 
input is from punched cards. The compiler reads the 
source input from the DD card named SYSIN. This card is 
not supplied in the catalogued procedure since the user 
must ao the specification. For card input the 
specification would be: 

//HAL. SYSIN DD * 



Source cards 



/* 
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where the * on the DD card indicated input to follow. For 
source images saved on some other medium, the HAL.SYSIN DD 
card must still be included, but the specification on the 
card must correctly identify the source file. Refer to 
the IBM JCL manuals for the techniques needed. 

2.1.5 Specifying the Standard Execution-Time Input 

v 

The catalogued procedure makes the assumption that 
the primary data input to the running HAL/S program will 
be made via sequential input file #5. This means that the 
catalogued procedure supplies a DD card with the name 
CHANNEL5. The use of the HAL/S statement 

READ (5) Specification list>; 

causes data to be read from the data set defined by the 
CHANNEL5 DD card. The catalogued procedure is organized 
to associate the following JCL cards with CHANNELS. 

//GO.SYSIN DD * 



Data cards 



This DD card may alternately be defined in any suitable 
manner to reflect the location of the desired input data. 

2.1.6 specifying the Standard Execution Time Output 

The catalogued procedure provides the necessary JCL 
to direct the results of the following HAL/S statement to 
a line printer: 

WRITE (6) Specification list>; 
The JCL statement responsible is the 

//CHANNEL6 DD . . . 
statement. 

2.1.7 specifying Additional Execution-Time JCL 

The HAL/S programmer may reference 10 separate 
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sequential files with HAL/S I/O statements. In HAL/S 
statements of the form 

READ 

WRITE } (n) Specification listing> 

READALL 

n may vary from through 9. These statements cause the 
requested I/O operation to occur on data defined by JCL 
cards of the following form: 

//CHANNELn DD Appropriate specif ication> 

where n is the same as in the HAL/S I/O statement. Cards 
of * this form may be added to the JCL brought in from the 
catalogued procedure by following the rules described in 
the IBM JCL publications. 



2.1.8 A Typical Run Submission 

The following JCL is an example of a typical user 
run. The user has his HAL/S program and his 
execution-time data on punched cards. In addition his 
program contains a WRITE (7) ... statement thai he wishes 
to direct to a card punch. 

1 //ANYNAME1 JOB installation dependent parameters> 

2 //TRYHAI EXEC HALSCLG, OPTION=« LISTIHG2 1 

3 //HAL.SYSIN DD * 



H Source Program 



5 /* 

6 //G0.CHANNEL7 DD SYSOUT=B 

7 //GO.SYSIN DD * 



a Data Cards 

* 

9 /* 

Comments on individual lines in the example: 

1 To identify himself to the operating system and give 
pertinent accounting information, the user must 
supply a JOB card. The form of this card is 
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installation dependent. Questions regarding its 
form should be directed to the installation 
operations staff. 

2 This is the EXEC card that causes the JCL saved in 

catalogued procedure HALSCLG to be. read by the 
operating system. The label TRYHAL is optional and 
if included may be any 1 to 8 character name 
beginning with a letter. If omitted, at least one 
blank must separate the // and the word EXEC. 
Following the name of the catalogued procedure, the 
user has coded some optional parameters as 
specified in Section 2.1.3 of this document. The 
OPTION keyword shown causes the string ' LISTING2' 
• to be available to the compiler. The compiler 
recognizes this as a directive to produce an 
auxiliary source listing (See Sec. 3.8). 

3 This card identifies the primary compiler input as cards 

immediately following. 

4 The source cards follow. 

5 The ./* delineates the end of the in-line source cards 

and indicates a return to JCL card processing. 

6 The CHANNEL7 DD card defines the destination of the 

HAL/S program's references to device #7 as system 
output class B (SYSOUT=B). At a typical 360 
installation this class refers to the card punch. 

7 GO. SYSIN defines the input data set associated with 

HAL/S references to device #5. f 

Note: Because of the way the HALSCLG catalogued 
procedure is written, this could also have 
been specified as: 

//GO.CHANNEL5 DD * " ; 

8 The data cards to be read from channel 5 come next. 

9 The /* terminates the input card data and indicates a 

return to JCL processing. No special end-of-job 
JCL indication is needed. The operating system 



will determine the job boundaries 
of subsequent JOB cards. 



by the occurrence 
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2.2 Compiler Outputs 



2. 2. 1 Source Listing 

As a result of the compilation process, a listing of 
the user-supplied source code is printed by the compiler. 
This primary listing has been formatted by the compiler to 
conform with standard output rules. The primary listing 
is always produced and is written to the data set defined 
by the SYSPRINT card. 

* The HAL/S compiler operates as two separate phases: 
Phase I or the syntax analysis phase and Phase II or the 
code generation phase. Each phase produces some 
informational and diagnostic output which together make-up 
the primary source listing. 

An optional unformatted listing is available. The 
user must specify the LISTING2 option in the OPTION field 
of the EXEC card which invokes the HAL/S catalogued 
procedure. 

The formats of both of these listings are discussed 
in Section 3. 



2.2.2 Tables 

In addition to reproducing the H&L/S language source 
code, the compiler also prints various tables that contain 
information of interest to the programmer. The tables 
include the Symbol Table 6 Cross Reference Table, giving 
name, type and usage information of identifiers, and the 
Macro Table giving a summary of replaced names. See 
Sections 3.6 and 3.7 for descriptions of these tables. 



2.2.3 Summaries 

The HAL/S compiler produces summaries of programmer 
actions taken within a particular program block at the 
close of that block and a quick-reference program layout 
description at the end of the compiled program. See 
Sections 3.3 and 3.4. 



2.2.4 Diagnostics 

The compiler produces error messages when syntax 
errors or other abnormal conditions Occur. These error 
messages are interlisted with the source listing. An 
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error summary is provided at the end of the Phase I 
listing. Section 4 discusses compile time diagnostics in 
detail. 

2.3 Subsequent Steps 



2.3. 1 Link Step 

after an object file has been produced as described 
above, it must be further processed into a form suitable 
for loading and execution. This process includes the 
resolution of any references to HAL/S library routines and 
the qeneration of appropriately sized work areas required 
by the HAL/S programs at run time. These tasks are 
accomplished in the second step of HALSCLG. This step 
invokes a program known as HALLINK, a HAL/S compiler 
system program which performs all necessary functions. 
The HALLINK program dynamically invokes the System/360 
Linkage Editor as part of its operation. 

The printed matter generated by this step in the 
HALSCLG procedure appears in three parts: 

1) A standard output produced by the Linkage Editor 
which may consist of a module map and size 
statistics. Descriptions of this listing may be 
found in the appropriate IBM system manual: 

IBM System/360 Operating System 
Linkage Editor and Loader 
Form C28-6538 



2) A HALLINK listing which documents the tree structure 
of all HAL/S modules involved in the link edit. 

3) A second standard linkage editor listing as described 
above. This listing will incorporate changes made to 
the module structure by the HALLINK program. This 
second link editor listing is the one corresponding 
to the final load module produced by this step. 

The HALLINK step puts its final result on a direct access 
device suitable for subsequent loading and execution. The 
load module thus produced requires a third step to be 
executed. 



2.3.2 The Execution Step 

The execution of a compiled HAL/S program may produce 
both user defined output and system diagnostic output. 

The user output occurs as a result of HAL/S I/O 
statements. The system diagnostic output can occur as a 
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result of execution errors detected by the system or as a 
result of user requests for dynamic dumps and traces. 



2.4 Creating and Running Program Complexes 



2.4.1 Introduction 

Section 2. 1 has explained how to run a self-contained 
HAL/S program. However the form of the language allows a 
HAL/S \ proqram to use data external to itself (COMPOOLS) , 
and to call external procedures or functions (CCKSTIBS) . A 
HAL/S program and the compools and comsubs it uses are 
collectively known as a PROGBAH COMPLEX. This section 
explains how to create and run a program complex. 



2.4.2 The Form of Compools and Comsubs 

This subsection briefly recapitulates the forms taken 
by compools and comsubs in the HAL/S language. Both 
compools and comsubs are treated by the HAL/S compiler as 
independently compilable entities in the same way as a 
program. 

The form of a corapool is illustrated by the following 
example: 



DATA: COMPOOL; 

DECLARE S SCALAR INITIAL (2.5) ; 
DECLARE I INTEGER INITIAL (5) ; 



CLOSE DATA; 



Fig. 2.1 



The form of a typical comsub is illustrated by the 
following example: 



ROUTINE: PROCEDURE (X) ; 

DECLARE X SCALAR; 

WRITE{6) X; 
CLOSE ROUTINE; 



Fig. 2.2 
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A program usinq data in the compool DATA and calling the 
comsub ROUTINE must contain the appropriate matching 
templates for them. Such a program is illustrated by the 
following example: 

DATA: EXTERNAL COMPOOL; 

DECLARE 5 SCALAR INITIAL (2. 5) ; compool 
DECLARE I INTEGER INITIAL (5) ; template 

CLOSE DATA; 

ROUTINE: EXTERNAL PROCEDURE (X) ; comsub 

DECLARE X SCALAR; template 

CLOSE ROUTINE; 

TEST: PROGRAM; program 

CALL ROUTINE (I/S) ; proper 

CLOSE TEST; 

Fig* 2.3 

The HAL/S language of course also allows comsubs themselves to 
access compool data and/or other comsubs. 

2.4.3 Compiling a Proqram Complex 

To compile a program complex, the program module, and the 
compool and comsub modules must each be compiled separately 
{although in any order). The compilation of each module is 
carried out in exactly the same way. For each compilation, a 
catalogued procedure should be used which incorporates JCL to 
enable the object module produced to be saved (e.g. the HALSC 
catalogued procedure in Appendix C) When all object modules 
have been created, they are linked together (and with the 
runtime library) by using the HALLINK program (eg. via the 
HALSL catoloqued procedure listed in Appendix C). The 
resultinq load module is then executed as described previously 
for a simple program. 

Each compilation also produces symbolic data used as a 
run-time debugging aid. In compiling and executing simple 
programs using the catalogued procedure HALSCLG, this symbolic 
data is written on a member of a temporary PDS passed to the 
load step of the JCL. These are two methods for insuring that 
the symbolic data for all modules of a program complex are 
correctly made available at execution time. 

(i) The symbolic data for each module is saved on a different 

member of a PES common to all compilations. In the 
execution step this dataset should be specified on 
the HALSIMB DD card. (See catalogued procedure in 

Appendix C . } 
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(ii) The symbolic data for each module is saved on a different 
PDS (each of which will therefore only have one 
member) . In the execution step the HALSYMB DD cards 
should specify the catenation of all the PDS * s used. 
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3. COMPILATION LISTINGS 



3.1 General Description 

The listinqs produced by the HAL/S compiler are designed 
to document the actions taVen by the compiler in the generation 
of an executable form of the user's source program. The user's 
code is reproduced in an annotated form and, optionally, in its 
original form.. All tables and error messages generated by the 
compiler ar-e also considered part of the documentation and are 
described in the following sections. 

3.2 Formats 

The numbered notes in the following discussion refer to an 
example of a HAL/S source listing shown in Figured . 



3.2.1 Headings 

A one-line page header (1) begins every page of the 
listing. It contains compiler version identification and 
page number within the listing. 

On . page one of the listing, the date and time of 
generation of the compiler are printed, followed by the 
date and time at which the current compilation was begun 
(2). 

Following any header information on each page of the 
listing, a field description line is printed (3). This 
line breaks the page into columns, the contents of which 
are described below. 



3.2.2 Statement Number 

The statement number field (4) headed by the title 
"ST1T" contains the compiler-assigned sequence number for 
each HAL/S statement. This field is filled in for each 
M-line in the source listing. The "STMT" field for E-line 
antf S-line entries as well as for comment cards and 
compiler directives is left blank. 



Note that the statement number is associated with a 
complete HAL/S statement, not with the physical number of 
H- lines. Thus, if a HAL/S statement spans several 

"-lines the same statement number will appear on each 
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M-line. 



3.2.3 Line Type 

The STMT field is followed by a blank and then by a 
single character field (5) used to indicate the type of 
source line. Hf.L/S has multi-line subscripting and 
exponentiation capabilities. Such multiple line use is 
identified for easier reading. 

The compiler places an indicator of line type in this 
one character field. The possible values of this field 
are: 

* 

C = Comment line 

D = Compiler directive line 

E = Exponent line 

S = Subscript line 

M = Main line 



These values correspond generally to the card types 
(punched in column 1) of the user's source cards. 



3.2.*i Source Field 

The next field on the page (6) is centered under the 
title "SOURCE". This field contains the actual HAL/S 
language text. The field is delimited by vertical bars at 
either side. The field is 100 characters wide and is 
filled by reformatted source text, complete with 
compiler-supplied annotation. 



3.2.5 Current Scope Field 

Following the source delimiter (|) at the right of the 
S0U3CE field,' is the variable length field headed by 
"CU3FENT SCOPE" (7) . This is an information field which 
contains the name of the HAL/S program block to which the 
current source line belongs. This field applies only to 
C, D, and ?! lines. 



3.2.6 Information Field 

To the right of the "COPHENT SCOPE" field is another 
variable length area that is used by the compiler to 
supply additional information. This information may be 
any compiler generated comments regarding the current 
line. This field is applicable only to K-lines. 
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3.3 The Output Writer 



3. 3. 1 Concept 

The HAL/S compiler has been designed to provide 
standard , automatic annotation of its output listing to 
enhance the readability of HAL/S cource code. The HAL/S 
system allows each programmer to enter programs in a 
free-form input consistent with individual coding 
preferences. The compiler then edits the input during 
compilation into the standard form so that all program 
listings will observe the same coding rules. 

Since HAL/S is a block-oriented language, the logical 
indenting of program blocks can do a great deal to enhance 
understanding of program structure. The programmer can do 
this indenting himself, but the problems of inserting new 
indentation levels into existing code often cause 
considerable wasted time in re-punching existing lines to 
maintain consistency. HAL/S frees the programmer from 
this task by completely regenerating the indentation 
scheme each time the program is compiled. Thus, the 
indentation is always complete and reflects the total 
program structure. 

Although HAL/S source input is in the form of 8 
column card images, the compiler treats the input as a 
continuous stream of information, with only the 
statement-delimiting semicolons to indicate statement 
boundaries. Each statement is stored internally until its 
semicolon is found. Then, with a complete statement in 
hand, the HAL/S output writer completely reformats the 
source. The reformatting includes referencing the symbol 
table to obtain the types of any variables in the 
statement so that the characteristic HAL/S overpunch mark 
may be supplied by the compiler. The reformatting also 
includes expansion of single line input to the full HAL/S 
multi-line form. Finally, the resulting multi-line, 
annotated statement is indented to the proper level 
determined by the line's relative position in the program. 
The statement is then placed on the output listing, using 
as many E-M-S groups as necessary to contain it. 

The specific conventions imposed on the output 

listing are detailed in the following sections. 



3.3.2 Auto-Indentation 

References in this section are to Figure 3.1 
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3.3.2.1 Declaration Statements. The output writer 
breaks up declaration statements in a way which 
provides maximum visibility of the intent of the 
declaration. The word DECLARE is aligned at the 
current indent-level. If the DECLARE has factored 
attributes, the attributes are placed on the same 
line as the DECLARE and a new line begun (8) . If 
no factors are present, variable names follow the 
DECLARE (9). Lists of variables without individual 
attributes are placed on the same line (10). The 
occurrence of a variable with attributes causes 
that variable to appear on a line by itself with 
its attributes (11). Any lines created after the 
•DECLARE line are indented one indent level. 

Structure declarations (12) are reformatted 
into the commonly used form. Each level of the 
structure template is placed on a seperate line 
with indenting appropriate to the level number. 



3.3.2.2 Labels. All statement labels (13) are 
right justified against the statement to which they 
apply. The statement itself is placed at the 
proper indent level before the label is applied. 
If the label will not fit on the same line as the 
statement body because of the indent location, it 
is placed on a separate H-line predeeding the 
statement body (14) . 



3.3.2.3 Scope Changes. Whenever a PROGRAM, 
PROCEDURE, TASK, FUNCTION, or UPDATE block is 
encountered, the statement is placed in the output 
listing at the current level and then the indent 
level is increased one increment (15). All 
statements within the block follow the normal 
indenting rules relative to the block level 
indentation. Thus, all statements within a block 
are indented farther than the block definition. 

When the corresponding CLOSE statement is found, 
the CLOSE statement is output at the same level as 
the block definition statement and the indent level 
is reset to its value before the block was entered 
(16). 



3.3.2.4 IF Statements. The IF ... THEN part of 
the statement is placed on the listing at the 
current indent level and the indent level is 
increased one increment. The "true part" of the 
statement is placed on the next level at the new 
indent level and the level is decremented one level 
(17). 3 _ 4 



If an ELSE clause is present, the "ELSE" gets a new 
line at the current level, which is the same level 
as the "IF", and the indent level is incremented. 
The "false part" of the statement is placed on the 
next line at the new level and then the level is 
decremented one level (18) • 



3.3.2.5 DO Groups. Ail types of DO groups receive 
the same treatment. The statement containing the 
DO is placed in the listing at the current indent 
'level and the level is incremented (19). All 
statements in the range of the DO are indented 
relative to this new level. The END closing the 
group is placed at the same level as the DO (20) . 

The DO CASE statement obeys the same indent rules 
as other DO statements, but some additional 
notation is supplied by the output writer. The 
first M-line of each case is annotated in the 
information field beyond the current scope notation 
with a message of the form "CASE n" where n is the 
current case number (21). If the current case is 
really a "case within a case", (i.e., a nested DO 
CASE is in effect), the notation is "CASE a.b 
... n" where the a.b ... indicates the 
structure of the case statements in the sense of: 
case n within case b within case a ... Also, the 
END associated with the DO CASE statement receives 
the additional information "DO CASE END" to help 
associate it with its group head (22) . 



3.3.2.6 Continuations. A reformatted E-H-S group 
may not fit on the printed page in a single group 
after the indentation rules have been applied. If 
this is the case, the output writer breaks the 
statement into as many E-M-S groups as necessary 
(23) . The break never splits an identifier or 
keyword. A literal character string may be broken. 



3.3.2.7 Page Boundaries. The output writer never 
places pieces of an E-tt-S group on separate pages; 
i.e. an 2- line at the bottom of one page and the 
corresponding H-line on the next. A page eject 
will always be performed before such a group is 
written. 



3.3.2.8 The first line of any PROCEDURE, FUNCTION, 
PHQCPAM, TASK, or UPDATE block always begins on a 
new page. 
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3.3.3 Multi-line Expansion and Annotation 
References are to Figure 3.1. 



3.3.3.1 overpunches. If, after having all 
pertinent subscripting applied, a variable name is 
of a type for which HAL/S has defined an overpunch 
character, the output writer supplies that 
character on an E-line above the variable name. 
The overpunch character is centered over the name. 

The characters available are "*", M - M , ".", »V\ 
" + '« for matrix, vector, bit, character, and 
structure data types respectively. The mark 
supplied is determined from the totally subscripted 
form of the variable. Thus the overpunch may be 
changed by subscripting. For example, an element 
of a matrix is a scalar. Therefore, a matrix name 
subscripted down to a particular element receives 
no overpunch (24). Similarly, a matrix variable 
subscripted to a particular row of the matrix 
receives a vector mark (25) . 



3.3.3.2 Array and Structure Notation. Variables 
which are structure terminals or which are arrayed 
may have additional annotation supplied. If a 
particular use of such a variable has multiple 
copies due to structure and/or array properties and 
if those multiple copies have not been subscripted 
away in the particular use of the variable, the 
variable is enclosed in the appropriate marks. 
Multiple copies due to arrayness receive brackets 
("[" and "]") while multiple copies due to 
structure copies receive enclosing braces ("{" and 
"}»). (26) 

As with variable typing (see Sec. 3. 3. 3. 1) , it is 
possible to subscript away the "arrayness" or 
"structureness" of a variable and thus have no 
special annotation appear. 

Note that the array and structure notation 
characters are available only on certain print 
trains such as the IBM TN chain. If a particular 
installation does not have such a print chain, the 
notation will probably appear as blanks (unprinting 
characters) . 
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HAL/S COMPILATION 



PHASE 1 



INTERMETRICS, 



C . 



VERSION 360-4 



PAGE 1 



HAL/S COMPILER PHASE 1 — VERSION OF SEPTEMBER 28, 1973. CLOCK TIME = 15:23:36.03. 



©- 



TODAY IS OCTOBER 9, 1973. CLOCK TIME = 11:53:20.40. 



DEMO: 
PROGRAM; 



SOURCE 



THIS IS A DEMONSTRATION PROGRAM TO SHOW THE LISTING PRODUCED BY 
THE HAL/S- 360 COMPILER 



REPLACE PRINTER BY "6"; 
DECLARE INTEGER INITIAL (1), ($\ 

A, B, C; 
DECLARE D, F, G; 
DECLARE E VECTOR (4) ; 
DECLARE H, I, J, © 

K ARRAY (5) MATRIX (3, 4) , r\ 
L, M, N, © 
SCALAR; Q^ 
STRUCTURE AA: ff\ 
1 BB, 

2 CC MATRIX (4, 3), 
•1 DD, 

2 EE ARRAY (4) MATRIX (3, 4); 
STRUCTURE QQ: 
1 BR, 

2 STRUCTURE AA, 
2 SS CHARACTER (5) ; 
DECLARE MY_STROCTURE QQ-STBUCTURE (5) ; 



CURRENT SCOPE (?) 



Q 



DEMO 

DEMO 

DEMO 
DEMO 
DEMO 
DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO' 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 

DEMO 



Fig. 3.1 The HAL/S Source Listing 



HAL/S COMPILATION 

STMT 

10 M| PROC1: (Q) 

10 M| PRJJCEEURE; 

11 Ml ^DECLARE A INTEGER; 

12 Ml IF A = B THEN (g) . 

12 K| DO; (l?)* 

13 M| (I3lL-ABEt1: B = C; 



PHJS 



INTER METRICS, INC 



SOURCE 



ND; 



ELS5. 



t)SE PBOC1; 



El 

'14 B| 

S| 

15 Ml 

16 Ml 

H- 16 M| 

* 17 Ml 

W 

HBLOCK SUMMARY 

o 
o 

3 . OUTER VARIABtES REFERENCED: 
(+ -B,'C 

OUTER VARIABtES CHANGED: 

B 



ft STBOCTIIRE.RE.DD.EE} = (KY_STRUCTnRE.RR.BB.CCJ i 

3:2,* *' 2 



VERSION 360-4 PAGE 2. 
CORRENT SCOPE 
| PROC1 
I PROC1 
| PROC1 
| PR0C1 
| PROC1 
| PROC1 

I 

| PFOC1 

I 

I PROC1 
| PROC1 
| PROC1 
| PROC1 



Pig. 3.1 (con't) 



„,WS C....1..... - ...... - " I......" !<=.. I"- «"«•»- »«' ' 

CUP.FENT SCOPE 
SOURCE 
STMT 

| DFMO 

18 M| DO FJiP C = 1 TO 100; 

Mfl ^ | DEMO 

19 Ml 0~- K <24) . | . 
S| C:2,3 

@| DEMO 
END; 
l DEMO 

21 B I DO CASE A; ,. /-n . " 

| DEMO CASE 1 {21) 

22 HI A = B; W 

I 

2 | - ^-~ 1 DEMO CASE 2 

23 Ml E = K (25) ; | 

SI B:T, * s-\ 

\ DEMO DO CASE END^) 

24 HI END; 

» - 
E j * I DEMO 

25 M| r Kl = 0; 

(rb * . - . i 



2 26 m! WEXTE(P^P) B^UCTUB^B.BB.CC^ ^ . [BY_STBOCTnHE.HB.DD.EE ^ ^ ^ D. ». P. 0, H. J DEMO 

• S| •— \ 

(26) ' I 

OJ E) V j DEMO 

M 26 Ml (23)l, 0, TK% L# H, N, 0; . 

Vi ^ I DEMO 

C> 27 H| CLOSE DEHO; 

O 
3 



Fig. 3.1 (con't) 



3.3.3.3 Subscripts and Exponents. HAL/S allows the 
user to supply source statements in single or 
multi-line format. The output writer expands all 
source to full multi-line format before printing. 

During the expansion process, any unnecessary 
subscript or exponent grouping parentheses are 
removed. These grouping parentheses are often 
needed in single line input to show the extent of a 
subscript or exponent field. 

Subscripts applied to variables on an exponent 
line, and exponents applied to variables on a 
subscript line, are left in single line format 
since multiple line expansion would produce an 
ambiguous listing. also, overpunch characters are 
not supplied for variables on exponent or subscript 
lines. 

The multiple lines are indicated by M E" and »S" in 
the line type field of the listing (see 3.2.3). As 
many E or S lines as needed to contain the expanded 
source are generated. 



3.3.3.4 REPLACE 1 d Symbols. Any symbols which are 
defined as replaced names in REPLACE statements are 
underlined by the output writer in the source 
listing (27) . 



3.3.4 Comments 



3.3.4.1 comment Cards and Directive Cards. All 
comment cards (C in column one) and directive cards 

(D in column 1) are transferred unchanged to the 
output listing. Groups of comment cards are 
separated by a blank line from other lines and 
single spaced within the group. 

3.3.4.2 In-Line Comments. Comments appearing on 
the M-lines of input source cards in the form of 

/* ... Comment ... */ 
are collected by the output writer and placed into 
the output listing after the statement has been 
processed. 

The collected comments are placed on the M-line of 
the statement if possible. If there is not room, 
spill-over can occur onto as many S-lines as are 
necessary. Multiple comments on a sin ale source 
statement are collected together and printed as one 
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comment. If the size of the total comment text for 
any one HAL/S statement reaches 256, additional 
comment text is ignored and a warning issued. 
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3„4 Block Summaries 



3.4.1 Concept 

The HAL/S compiler provides a summary of action taken 
within a program block at the close of the particular 
block. The blocks for which summaries are given are 
PROGRAM, TASK, FUNCTION and UPDATE. When the" matching 
CLOSE to such a block is found, the summary is issued and 
the listing of the program resumes with a skip to the new 
page. 



3. U. 2 Information Provided 

Information contained in block summaries consists of 
lists of labels or variable names used in various contexts 
within the block. The title "BLOCK SUMMARY" begins the 
list. For all potentially summarized contexts within the 
block, a descriptive heading is printed followed by the 
list of names involved. The headings and their meanings 
are listed below. 



a) PROCEDURES CALLED - A list of PROCEDURE names which 
appeared as the object of a CALL statement somewhere 
in the current block. The names noted here have been 
defined as labels of PROCEDURE statements within the 
current program but outside this local block. 

b) FUNCTIONS INVOKED - A list of user defined functions 
which were referenced within the current block. Only 
functions defined outside the current block are 
tabulated. 

c) ERRORS SENT - A list of the HAL/S error numbers which 
are sent explicitly by a SEND ERROR statement 
somewhere in the current block. This is the* only 
summary which does not involve a list of identifier 
names. 

d) PROGRAMS SCHEDULED - A list of independent programs 
scheduled in the current block via the HAL/S SCHEDULE 
statement. 

e) TASKS SCHEDULED - A list of tasks appearing as the 
object of a SCHEDULE statement somewhere in the 
current block. 

f) PRIORITIES UPDATED - A list of task identifiers 
referenced by an UPDATE PRIORITY statement within the 

current block. 
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h) 



a) EVENTS SIGNALLED - A list of event variables declared 
outside the current scope and appearing an the 
current block as the object of a SIGNAL statement. 

EVENTS WAITED FOR - A list of event variables declared 
outside the current block and appearing in the blocK 
as terms in an event expression. 

i) OUTER VARIABLES REFERENCED - A list of data names 

declared at a level global to the current block which 
are referenced but not changed by the current block. 
Contexts in which such variables are tabulated this 
way- include appearance in expresisons, output lists, 
CALL statement parameter lists, etc. 

■N OUTER VARIABLES CHANGED - A list of data names declared 
at a level global to the current block which are 
assigned new values within the current block. 
Contexts interpreted this way include appearance on 
the left-hand side of an assignment, input lists, 
CALL statement ASSIGN lists, etc. 

OUTER REPLACE DEFINITIONS USED - A list of identifiers 
declared by appearance in a REPLACE statement in a 
scope global to the current block, which were used 
within the current block. 

IMPLICITLY DECLARED VARIABLES - A list of identifiers 
which had not been defined before their use in the 
current block and which therefore had default 
declarations assumed for them. 



k) 



1) 



Note that in all categories except c and 1, ° nl ? J^^; 
which have a NEST level less than that of the current 
block are included, as the block summary is an ^ication 
of the impact of this block outside of its own local 
variables or sub blocks. A block which " completel y 
self-contained, no matter how complex, will not have a 
block summary issued. 

The order of names in any list within the block 
summary indicates the order of occurrence of f ijst Jisages 
of these names in the block within the identified context. 

The block summary for any block will not duplicate 
the information in the block summary for any block nested 
within it (i.e. if Procedure A contains Procedure B which 
schedules Program C, Procedure B«s block summary will 
indicate that Program C was called, but Procedure A«s will 
not) . 
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3.5 Program Layout Summary 

Immediately preceeding the Symbol Table printout at the 
CLOSE of the HAL/S program, there is a program layout map, 
indicating the wa in which PROGRAMS, TASKS, PROCEDURES, 
FUNCTIONS, and UPDATE blocks were defined. The indent level in 
this printout indicates the nesting level definition of the 
block shown. This serves to give a quick overview of the 
program structure. Such a listing can be of assistance not 
only as a documentation aid, but also as a guide to locating 
the definition of procedures and functions which have been 
diagnosed as" undefined by the compiler. 



3.6 Symbol S Cross Reference Table Listing 

The symbol and cross reference table printed at the end of 
a HAL/S compilation listing provides a detailed accounting of 
all programmer-defined symbols. The table listing is organized 
into two parts: a structure template listing and an 
alphabetized total listing. 

Any structure templates defined in the compilation appear 
first in the symbol and cross reference table. The template 
names appear in alphabetical order. The body of each template 
(ie. the levels defined under the template name) is listed 
under the template name in the order of definition. This 
ordering provides a quick reference to the organization of the 
structure template. Special action is taken in the "NAME" and 
"TYPE" fields (described below) to highlight the template 
organization. 

Following the listing of any templates, an alphabetized 
listing of all programmer-defined symbols is printed. Symbols 
previously listed as elements of a structure template are 
included in this list. However, the list is completely 
alphabetized and template organization is not shown. When a 
particular symbol is independently defined in more than one 
name scope, the symbol is multiply listed in order of 
definition. Figure 3.2 illustrates the form of a HAL/S 
compiler symbol and cross reference table. 

3.6.1 "DCL" Field 

The "DCL" field is used to list the compiler-assigned 

statement number at which the identifier was first 
declared. For explicit declarations, this number will 
point to a DECLARE statement somewhere in the program. 
For implicit declarations, this number is the statement at 
which the identifier was first used in ths? program. 



3.6.2 "NAME" Field 
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The "NAME" field lists the symbolic name of the 
programmer-defined symbol. The width of this field is 
determined by the length of the longest symbol in the 
compilation. An asterisk preceeding the name indicates 
that the varaible was implicitly defined. 

Within the first part of the symbol table listing 
which contains structure template names and their 
organizations as described in Section 3.6, all parts of 
the template body have their names indented one space from 
the structure template name under which they are defined. 
In this same template description section, all nested 
template references are indicated as »**« in the "NAME" 
field 'since there is no programmer-defined symbol 
available. 



3.6.3 "TYPE" Field 

The "TYPE" field describes the type of each 
programmer-defined identifer. This field will contain 
one of the following descriptions: 

INTEGER 

SCALAR 

n - VECTOP 

n X m MATRIX 

BIT (n) 

CHARACTEP (n) 

EVENT 

PROGRAM 

PROCEDURE 

STATEMENT LABEL 

STRUCTURE 

STRUCTURE (n) 

STRUCTURE NODE 

TEMPLATE REFERENCE 

REPLACE MACRO 

The values of n and m indicate si2e or dimensionality in 
their particular contexts. 

Additional information may appear in the type field. 
If the identifer has an array specification, the word 
"ARRAY" will follow the basic type specification as in: 

"INTEGER ARRAY" 

If the identifier is a function name, the type 
specification will be followed by the word "FUNCTION" as 
in: 

"3 - VECTOR FUNCTION" 
Within the first part of the symbol table listinq 
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which shows the organization of structure templates, the 
"TYPE" field contains additional information to indicate 
the hierarchical relationships which exist within the 
structure templates. For each symbol which is part of a 
structure template, the "level number" of the symbol is 
printed in front of the type information for the symbol. 



3.6.4 "ATTRIBUTES S CROSS REFERENCE" Field 

This field contains all declared attributes of the 
symbol, lists all cross reference information, and 
contains comments about the identifier 4 s use. 

Attributes: This part of the field lists all data 
declaration attributes of variables or labels. In 
addition, special information about structure 
template elements is provided. The possible 
attributes which may appear are: 

ARRAY (n,n,n) 

SINGLE 

DOUBLE 

LOCKED 

DENSE 

ALIGNED 

ASSIGN PARM 

INPUT PAEM 

AUTOMATIC 

STATIC 

LATCHED 

PROCESS EVENT 

INITIAL 

CONSTANT 

ACCESS 

REENTRANT 

EXCLUSIVE 

EXTERNAL 

<template name>-STRUCTURE 

Elements of structure templates have their full 
attributes listed in the first part of the symbol 
table listing where they are shown under their 
appropriate template name. In the alphabetized 
second part of the listing, these structure 
template elements will appear again but their 
attributes will not be repeated. Instead the 
notice: 

h*#* SS c; STRUCTURE TEMPLATE <template name>" 
will appear directing attention to the hierarchical 
template listing of the structure template whose 
name is given. 

The attributes of a REPLACE MACRO entry will 
contain only the message: 

"MACRO-TEXT IND3X=<number>" 
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HAL/S COMPILATION 



PHASE 1 — INTERKETRICS, INC 



VEF.SIOH 360-4 PAGE <♦ 



PROGRAM LAYOUT 
DEMO: PROGRAM; 

PROC1: PROCEDURE; 



<3 






Fig. 3.2 The HAL/S Program Layout and Symbol & Cross Reference Table Listing 



HAI/S COMPILATION 



PHASE 



INTER PI ETHICS 



INC 



VERSION 360-4 



PAGE 



SYMBOL S CROSS REFERENCE 



TABLE 



LISTING 



DCL 



(CROSS REFERENCE FLAG KEY: 4 ■ ASSIGNMENT, 2 = REFERENCE, 1 = SOBSCRIPT USE, = DEFINITION) 
NAME TYPE ATTRIBUTES 6 CROSS REFERENCE 





7 


AA 




7 


BB 




7 


CC 




7 


DD 




7 


ES 




a 


QO 




8 


PS 




8 


** 




8 


SS 




3 


A 




11 


A 




3 


B 




7 


BB 


*J 


3 


C 




7 


CC 


*M 


4 


D 




7 


DD 


Lo 


1 


DEMO 


« 

to 


5 


E 




7 


EE 


/-K 


H 


F 


o 






o 






& 


a 


G 



6 H 

6 I 

6 

6 K 

6 L 

13 LABF.L1 

6 H 

9 MY STRUCTURE 

6 N 



2 


PRINTER 


10 


PROC1 


8 


RS 


8 


SS 



STRUCTURE TEMPLATE 
1 STRUCTURE NODE 

2 4X3- MATRIX 
1». STRUCTURE NODE 

2 3X4 MATRIX ARRAY 
STRUCTURE TEMPLATE 
1 STRUCTURE NODE 

2 . TEMPLATE REFERENCE 

2 CHARACTER (5) 
INTEGER 
INTEGER 
INTEGER 

STFUCTURE NODE 
INTEGER 
4X3 MATRIX 
SCALAR 

STFUCTURE NODE 
PROGRAM 
4 - VECTOR 
3X4 MATRIX ARRAY 
SCALAR 

SCALAR 

SCALAR 

SCALAR 

SCALAR 

3X4 MATRIX ARRAY 

SCALAR 

STATEMENT LABEL 
SCALAR 

STPUCTURE{5) 
SCALAR 

SCALAR 

REPLACE MACRO 
PROCEDURE 
STRUCTURE NODE 
CHARACTERS) 



0007 2 0008 

0007 POSSIBLY 

XREF: 0007 2 

0007 POSSIBLY 



ALIGNED XREF: 
ALIGNED XREF: 
SINGLE, ALIGNED 
ALIGNED XREF: 
ARRAY (4), SINGLE, ALIGNED 
ALIGNED XFEF: 0008 2 0009 
ALIGNED XREF: 0008 POSSIBLY 
AA-STRUCTUFE, ALIGNED XREF: 
ALIGNED XREF: 0008 POSSIBLY 
SINGLE, ALIGNED, STATIC, INITIAL 
SINGLE, ALIGNED, STATIC XREF: 
SINGLE, ALIGNED, STATIC, INITIAL 

**** SEE STRUCTURE TEMPLATE AA 
SINGLE, ALIGNED, STATIC, INITIAL 

**** SEE STRUCTURE TEMPLATE AA 
SINGLE, ALIGNED, STATIC XREF: 

**** SEE. STFUCTURE TEMPLATE A A 
XPEF: 0001 
SINGLE, ALIGNED, STATIC XREF: 

**** SEE STRUCTURE TEMPLATE AA 
SINGLE, ALIGNED, STATIC XREF: 
***** error ***** REFERENCED BUT 
SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** REFERENCED BUT 
SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** REFERENCED RUT 
SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** FEFEPENCED BUT 
SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** REFERENCED. BUT 
ARRAY (5), SINGLE, ALIGNED, STATIC 
2 0026 

SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** REFERENCED BUT 

XREF: 0013 NOT REFERENCED 
SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** REFERENCED BUT 
QQ-STRUCTUFE, ALIGNED, STATIC 
SINGLE, ALIGNED, STATIC XFEF: 
***** EFROF ***** REFERENCED BUT 
SINGLE, ALIGNED, STATIC XREF: 
***** ERROR ***** REFERENCED BUT 
MACRO-TEXT INDEX=1 XREF: 
XPEF: 0010 NOT REFERENCED 

**** SEE STRUCTURE TEMPLATE QQ 

**** SEE STRUCTURE TEMPLATE QQ 



NOT USED 
0014 2 0026 

NOT USED 
XREF: 0007 



POSSIBLY NOT ASSIGNED 
4. 0014 2 0026 



NOT USED 

0008 
NOT USED 

XREF: 0003 2 0021 4 0022 1 0023 

0011 2 0012 4 0016 

XREF: 0003 2 0012 4 0013 2 0022 



.XREF: 0003 
Q004 4 0019 



2 0013 2 0016 4 0018 
2 0026 



1 0023 
1 0019 



0005 4 0023 2 0026 



0004 2 0026 
NOT ASSIGNED 

0004 2 0026 
NOT ASSIGNED 

0006 2 0026 
NOT ASSIGNED 

0006 2 0026 
NOT ASSIGNED 

0006 2 0026 
NOT ASSIGNED 

XREF: 



0006 2 0019 2 0023 4 0025 



0006 2 0026 
NOT ASSIGNED 

0006 2 0026 
NOT ASSIGNED 

XREF: 0009 

0006 2 0026 
NOT ASSIGNED 

0006 2 0026 
NOT ASSIGNED 

0002 2 0026 



6 0014 2 0026 



MACRO TEXT LISTING: 



Fig. 3.2 (con't) 



HAL/S COMPILATIO 

,OC TEXT 
1 6 



'PHASE 1 - I ■ T E R H E T 8 I C S , " I W C ". . VISION 360-4 PAGE 6 



H- 
U5 






o 

3 



Fig. 3.2 (con't) 



which directs the reader to the appropriate entry 
in the Macro Text Listing for a definition of the 
replace text. 

Cross References: The remainder of the line, 
following any attributes and the word "XREF: M , is 
devoted to a list of all references to the 
identifier in the format: 

N XXXX 

where XXXX is a four digit specification of the 
line numher of the HAL/S statement containing the 
identifier. N is a cross reference flag which 
specifies the identifiers usage: 

Flag Code: N Dse of Identifier 

Definition 

1 Subscript 

2 Reference 

3 Subscript and reference 

4 assignment 

5 Subscript and assignment 

6 Reference and assignment 

7 Reference, assignment, and subscript 

Comments: Following the last reference listed for 
each variable, the compiler may insert a comment 
about the variable usage. Possible comments are: 



NOT USED if the identifier appears in a 
DECLARE statement but is neither referenced 
or assigned. 

NOT REFERENCED if the variable is assigned a 
value but never used in any reference 
context. 

NOT ASSIGNED if the variable value is 
referenced but never appears in any context 
where it can receive a value. This is 
obviously an error situation involving the 
use of an uninitialized variable. Therefore, 
the Symbol Table & Cross Reference listing 
contains the error message: 
n*****ERR0R*****R3FE'FSNCED BUT NOT ASSIGNED" 
to call attention to this situation. 



3. 7 Macro Table 

Following the cress references, there will be a ?5ACP0 TEXT 
listing if any REPLACE definitions appear in the program. 
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IT) 



UJ 



COMPILATION 



1 Kl DEMC:PROGRAM; 



PHASE 



UNFOBMATTED SOURCE LISTING 



PAGE 1 



C| 
CI 
C| 
CI 



THIS IS A DEMONSTRATION PBOGBAM TO SHOW THE LISTING PRODUCED BY 
THE HAL/S-360 COMPILER 



2 M| REPLACE PRINTER BY »6»;. 

3 M| DECLARE INTEGER INITIAL (1) , A, B,C;- 

4 Ml DECLARE D ,F,G; 

5 Ml DECLARE E VECTOR (4); 

6 M| DECLARE H,I,J,K ARRAY (5) MATRIX (3,4) ,L,M,N,0 SCALAR; 

7 Ml STRUCTURE AA: 

7 HI 1 BB,2 CC MATRIX (4,3), 1 DD,2 EE ABRAY(4) MATRIX (3, 4) 

7 Ml ; 

8 M| STRUCTURE QOz 
8 M| 1 FR, 

8 Mi 2 STRUCTURE AA, 

8 K! 2 SS CHARACTER (5) ; 

9 Ml DECLARE BY_STBUCTURS QQ-STRUCTURE(5) ; 

■ r 

10 MI PROC1:PROCEDDRE; 

11 Ml DECLARE A INTEGER; 

12 Mi IF A=B THEN DO; 

13 H| LABEL1:B=C; 

14 M| MY_STRUCTURE.BR.DD.EE$(3:2,*)= 

14 K| MY_STRUCTURE-RR.BB.CC$(*,2) ; 

15 M| END; 

15 M| ELSE A=C; 

17 Ml CLOSE PROC1; 

18 «| DO FOE C = 1 TO 100; 
19 ".\ 0=KS(C:2,3); 

20 -\ r.'IO; 



I 1 



DEHO 



Fig. 3.3 The HAL/S Unformatted Source 
Listing and Additional PHASE I Information 



1 2 
| 3 

1 4 
J 5 


DEMO 

DEMO 
DEMO 
DEMO 


1 6 


DEMO 


1 7 


DEMO 


1 8 


DEMO 


1 9 


DEMO 


J 10 


DEMO 


I 11 


DEMO 


1 12 


DEMO 


1 13 


DEMO 


I 14 


DEMO 


1 15 


DEMO 


| 16 


DEMO 


1 17 


DEMO 


| 18 


DEMO 


| 19 


PROC1 


| 20 


PROC1 


1 21 


PROC1 


I 22 


. PROC1 


1 23 


PR0C1 


| 24 


PROC1 


1 25 


PROC1 


| 26 


PROC1 


1 27 


DEMO 


1 28 


DEMO 


| 29 


DEMO 


1 30 


P2»:> 



H» l/S' COBPIUI 101 



PHASE 



INTEBMETBICS 



INC 



VERSION 360-U 



PAGE 



CALLS TO SCAN * 297 

CALLS TO IDENTIFY = 80 

NUM3ES OF REDUCTIONS = 803 

MAX STACK SIZE = 8 

MAX IND. STACK SIZE = 9 

END IND. STACK SIZE = 1 

MAX EXT_ARRAY INDEX = 6 . 

XF.EF LIST ENTP.IES = 69 

STATEMENT COUNT = 27 

NUMBER OF SYMBOLS = 30 

MINOR COMEACTIFIES =2 

MAJOR COMPACTIFIES » 

MAX NESTING DEPTH = 2 

FPEE STRING AREA = 26K77 

END OF HAL/S PHASE 1, OCTOBER 9, 1973. CLOCK TIME = 11:53:28. «0. 

38 CARDS WERE PROCESSED. 

ERROR OF SEVERITY 1: ONE OR MORE VARIABLES WERE REFERENCED BUT NOT ASSIGNED; SEE CROSS REFERENCE TABLE. 

TOTAL ELAPSED TIKE IN PHASE 1 0:0:8.02. 

ELAPSED PHASE 1 SET OP TIME 0:0:0.25. 

ELAPSED PHASE 1 COMPILING TIME 0:0:7.08. 

ELAPSED PHASE 1 CLEAN-UP TIME 0:0:0.69. 

PROCESSING RATE: 322 CARDS PEB MINUTE. 

*j 
vQ 

w V 

rT 
o 

3 



Fig. 3.3 (con't) 
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CO 
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o 
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Fig. 3.3 (con't) 



| 31 DEMO 
| 32 DEMO 



21 K| DO CASE A; 

22 K| A=B; 

23 M| e=k$(B:A,*); I 33 DE "° 

24 Ml END; 

25 M| K=0: 

26 Ml KEITEfPRINTBB) MY.STRUCTORE.RR. BB. CCS (3; 1 TO 3,*) , HY_STRCCTORE.RR.DD.EE I 36 DEMO 

26 «| ${2;2 TO <»:) , D,E,F,G,H,I, J,K,l,M r N,0; I 37 DE "° 

27 M| CLOSE DEMO; ' 38 



| 3U DEMO 
| 35 DEMO 



Fig. 3.3 contains a HACRO TEXT listing. The LOC field refers 
to the TYPE field in the symbol table listing for REPLACE class 
variables, and the TEXT indicates the string which was 
substituted whenever the identifier was encountered. REPLACE 
definitions are cross-referenced as well as any identifiers 
which may occur within replacement string. 

3.8 Optional Unformatted Listing 

The primary source listing generated by the HAL/S compiler 
is completely reformatted by the output writer. As a result, 
the source text has lost its relationship to the original card 
image input. 

In order to give the programmer a correlation between the 
primary source listing and his original input, the HAL/S 
compiler will supply an optional unformatted source listing. A 
sample of such a listing is shown in Figure 4. 

This option is reguested by including the word ,, LISTING2 ,, 
in the OPTION field of the JCL (see Section 2.1.3). 



3.8.1 Format 

The optional listing contains card images as read 
from the SYSIH DD card. These images receive no 
compiler-generated annotation. Each card image is 
bracketed by vertical bars (|). 

To the left of each image, the compiler prints the 
card type identification from column one of the input 
card. The HAL/S statement number of the first statement 
included on the card is also printed to the left of the 
card type. This statement number is the same as the one 
assigned to the expanded source by the compiler in the 
primary source listing. 

To the right of the card image, the compiler places a 
seguential card number, one number per card, which simply 
indicates a card's relative position in the input deck. 

Current Scope information is supplied in the same 
manner as in the primary listing. No other information is 
put into the auxiliary listing. This listing does not 
receive any error indication messages. 



3.9 Additional Information 

Immediately following the flacro Text Listing, the compiler 
prints a list of internal statistics for use in compiler 
development. These statistics can be ignored by the 
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programmer. 



3.10 Phase II Listing 



The Phase II listing of the HAL/S Compiler identifies 
itself ana lists current date and time before entering into the 
code generation process (see fig. 3.4) . 

If the *0PTI0NS=« field in the EXEC statement of the JCL 
specifies the 'LIST' option, a listing of all control section 
names needed by the compiled program is produced { see fig. ) . 
The format of this listing is typical of IBM model 360 
compilers and translators. 

Following this, a completely formatted object module 
listing will be produced (see f ig.&4) . This listing shows the 
complete code generated for each control section in both 
hexadecimal and pseudo- assembler formats. This is listed 
after a line in the following format: 

ST#n EQU * 

where n is the compiled HAL/5 statement number, and , ST#n» is 
in the label field. The label field is also used to indicate 
both HAL/S labelnames ana internal branch points in the same 
format as the HAL/S statement number indicator. The comments 
field gives information about the symbolic operand referenced 
by the instruction. 

Following this is a map of relocation information included 
in the produced object module. 

Hegardless of whether 'LIST' was specified or not, a 
listing of several performance statistics is printed next. 
These are included to aid in compiler generation, and are of no 
concern to the programmer. 
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HAL/S COHPILATION — PHASE 2 — INTEBMETRICS, INC. PAGE 8 

HAL/S COMPILER PHASE 2 — VERSION OF OCTOBER 1, 1973. CLOCK TIME » 12:43:52.98 
HAL/S PHASE 2 ENTERED OCTOBER 9, 1973. CLOCK TIME = 11:53:33.65 









Fig. 3.4 The HAL/S PHASE II Listings 



_„,-* 7 TMTERMETRICS, IKC. 

COMPILATION — PHASE 2 iBir.ni 



H A I / S 

2SDID SAME TYPE LENGTH BLOCK NAME 



0001 


$DS«0 


0000 


000218 


DEMO 


0002 




0004 


000074 


PROC1 


0003 




OOOU 


0000C5 




0004 




0004 


000608 




0005 


3PEHO 


0002 






0006 


10 I NIT 


0002 






0007 


M21SNP 


0002 






CO 08 


EOUI 


0002 


au 








U) 



O 

o 
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Fig. 3.4 (con't) 



HAWS COHtltlllOB — PHASE 
LCCCTR CODE LABEL INSN OPSPANDS 



2 — INTEBMETBICS, 
SYMBOLIC OPERAND 



INC 
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000000 
000000 
000000 
000000 
000004 
OOOC08 
00000A 
O0000E 
00000F 
000010 
000014 
000018 
000018 
000358 
000358 
00035A 
00035A 
O0035C 
00035C 
00035S 
00035E 
00035S 
£000352 
\Q 00035E 
• 00035E 
, 00035E 
. C0035E 
*» 000018 
000218 
^000218 
O 0C0218 
3 00021C 
~ 000220 
£ 000222 
000226 
000228 
000228 
000228 
00022C 
000230 
000238 
000238 
000238 
00023C 
000200 
000240 
000244 
000248 
00024C 
000250 
000254 
000258 
00025C 
000260 
—000264 



ST#1 

SDBMO 

DEMO 



47FOF010 

00000290 

0058 

04C4C5D4 

D6 

00 

5830F004 

986AB080 



0001 
0001 
0001 



ST #2 
ST#3 
$DEHO 

ST*3 

ST#3 

ST#4 

ST«4 

ST»5 

ST*6 

ST#7 

ST#8 

ST#9 

ST#10 

$DEHO 

$DEHO 

PR0C1 



47F0F010 

00000290 

0058 

05D7D9D6 

C3F1 



ST#11 
ST#12 



4820A006 
4920A002 
476F0068 



ST*13 

LABEL 1 



4820AO04 
4020A002 

41900001 
50900050 
4C9030A6 
5880D050 
4C80B0A6 
4129A0D4 
4138A038 
4140000C 
41000004 
_k5JL0C06O 



ST#14 



EQU 

CSECT 

EQU 

BC 

DC 

DC • 

DC 

DC 

DC 

L 

LM 

E0.n 

EQU 

CSECT 

DC 

EQO 

DC 

EQU 

DC 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

EQU 

CSECT 

CSECT 

EQU 

BC 

DC 

DC 

DC 

DC 

EQU 

EQU 

LH 

CH 

BC 

EQU 

EQU 

LH 

STH 

EQU 

LA 

ST 

HH 

L 

MH 

LA 

LA 

LA 

LA 

BAL 



ESDID* 0001 



15,16(0,15) 

A'00000290' 

X'0058' 

X'04C4C5D4' 

X'D6' 

X'OO' 

11,4(0,15) 

6,10,128(11) 

* 



ESDID* 0004 



X'OOOV 

* 

X'0001' 

* 

X'0001' 

* 

* 
* 
* 



ESDID= 0001 
SSDID= 0002 



15,16(0,15) 

A'00000290' 

X«0058» 

X'05D7D9D6' 

X'C3FT 

* 

2,6(0,10) 

2,2(0,10) 

6,104(15,0) 

* 

* 

2,4(0,10) 

2,2(0,10) 

* 

9,1(0,0) 

9,80(0,13) 

9,166(0,11) 

8,80(0,13) 

8,166(0,11) 

2,212(9,10) 

3,56(8,10) 

4,12(0,0) 

0,4(0,0) 

14,96(0,12) 



A 

B 

000280 LBL#1 



C 
B 



H'248' 

H'248« 

MY STRUCTURE+156 

MY~STRUCTURE 



71SNP 



Ir, 



H A L / S 
LCCCTR CODE 



COMPILATION 



PHASE 



LABEL INSN OPERANDS 



000268 
00026C 
000270 
000274 
000278 
000278 
000278 
000230 
0C0280 
000224 
000288 
000288 
000238 
000018 
000013 
000018 
00001C 
00001C 
000020 
000021 
00002C 
00002C 
h 000030 
j. 000034 
i 000038 
00003C 
000040 
000040 
* 000040 
000044 
J* 000048 
> 00004C 
3 00004C 
f OC004C 
-* 000050 
000054 
00005C 
000064 
000068 
000070 
000074 
OC0078 
00007A 
0C007A 
00007E 
000082 
000082 
00008 A 
00008A 
00003E 
0C0092 
' 000092 
0C009A 
O0C09A 
-" 0C009E 



41900001 
5A90D050 
4990B0A8 
47CF002C 



47FF0070 

4820A004 
4020A006 



ST#15 
ST#16 

LBL#1 



47F0C004 



41900001 

4090A004 
499030A4 
472F004C 

4C90B0A2 
4C90B0A0 
89900002 
7829A028 
7020A008 



ST*17 
LBL#3 

$DEHO 
ST#18 

LBL#6 



ST#19 



ST#20 
LBL#5 



41900001 
4A90A004 
47FF001C 



LBL#4 
ST#21 



4820A000 
5920B098 
474F007A 
413F00D4 
59203000 
472F007A 
89200002 
58E23000 
07F3 

45EOC018 
0D00033A 

47FF00E0 

4820A002 
4020A000 

47FF00EO 

4890A002 
4C90BOA2 



LBL#12 

ST#22 

LBL*13 

ST#23 
LBL#15 



LA 

A 

CH 

BC 

EQU 

EQO ■ 

BC 

EQU 

LH 

STH 

EQO 

EQU 

BC 

CSECT 

EQU 

LA 

EQU 

STH 

CH 

BC 

EQO 

MH 

MH 

SLL 

LE 

STS 

EQO 

EQO 

LA 

AH 

BC 

EQO 

EOU 

LH 

C 

BC 

LA 

C 

BC 

SLL 

L 

BCH 

EQO 

BAL 

DC 

EQO 

BC 

EQO 

LH 

STH 

EQU 

BC 

EQO 

LH 

MH 



9,1(0,0) 

9,80(0,13) 

9,158(0,11) 

12,44(15,0) 

* 

.15,112(15,0) 
* 

2,4(0,10) - 
2,6(0,10) 



15,4(0,12) 

ESDID= 
* 

9,1(0,0) 
* 

9,4(0,10) 
9,164(0,11) 
2,76(15,0) 
* 

9,162(0,11) 
9,160(0,11) 
9,2 

2,40(9,10) 
2,8(0,10) 



0001 



9,1(0,0) 

9,4(0,10) 

15,28(15,0) 

* 

2,0(0,10) 

2,152(0,11) 

4,122(15,0) 

3,212(15,0) 

2,0(0,3) 

2,122(15,0) 

2 2 

14,0(2,3) 

15,14 

* 

14,24(0,12) 

A'0D00033A» 

* 

15,224(15,0) 

* 

2,2(0,10) 

2,0(0,10) 

* 

15,224(15,0) 

* 

9,2(0,10) 

9,162(0,11) 



2 — INTERHETRICS, 
SYMBOLIC OPERAND 



H«5' 
000244 



INC 
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000288 LBI#3 

C 
A 



C 

H'100' 
00004C LBL#4 

H«3' 

H'4» 

K+28 

D 



00001C LBL*6 



A 

FM' 

00007A LBL#12 

0000D4 LBL#11 

00007A LB1#12 



ERPSND 



0000E0 LBL#9 

B 

A 

0000E0 LBL#9 

B 
H«3' 



Fig, 3.4 (con't) 



an/s 

LCCCTR CODE 



COHPILATION 



PHASE 



LABEL ISSN OPERANDS 



0000A2 
00C0A6 
0000AA 
OOOOAE 
00OOB2 
OO00B6 
O00OBA 
0000BE 
0000C2 
OOO0C2 
0000CA 
OOOOCA 
0000D4 
O00OD4 
O00OD8 
OOOODC 
OOOOEO 
OOOOEO 
OOOOEO 
0OOOE4 
0000E8 
OOOOEC 
OOOOFO 
! 0000F2 
000076 
OOOOFA 
OOOOFS 
000102 
000106 
00010A 
' 00010E 
00010E 
000112 
000116 
000118 
00011C 
000120 
000122 
000126 
00012A 
00012C 
000130 
000134 
000138 
00013C 
000140 
000111* 
0C0148 
00014A 
00014E 
000152 
, 000154 
000158 
■ 000 15C 

1 ft AttlC ft 



4A90AO0O 
4C90B0A0 
89900002 
4B90B09E 
4120A02C 
4139A00C 
41000004 
45EOC040 



47FF00E0 

47FF00E0 

00000002 
0000008A 
0000009A 



ST#24 

LBL#17 

L8L111 



LBLS9 
ST#25 



41900C01 

5090D050 

4C90B09C 

89900002 

2B00 

4129A00C 

4100000C 

4520C0F8 

41900001 

5A90D050 

499OB0A8 

47CF00E4 



ST#26 



41100006 

41000003 

05SC 

00000000 

4130A31C 

1B44 

41000003 

41100003 

05EC . 

cooooooo 

41900001 

50900050 

4C90B0A2 

4C90B0A0 

89900002 

4139A254 

1344 

41000003 

41100004 

05EC 

CCOOOOOO 

41900001 

5A90D050 

(l93AB0A2^ 



AH 

HH 

SLL 

SH 

LA 

LA 

LA 

BAL 

EQU 

BC 

EQU 

BC 

EQO 

DC 

DC 

DC 

EQO 

EQU 

LA 

ST 

KH 

SLL 

SDR 

LA 

LA 

BAL 

LA 

A 

CH 

BC 

EQO 

LA 

LA 

BALE 

DC . 

LA 

SE 

LA 

LA 

BALE 

DC 

LA 

ST 

MH 

«H 

SLL 

LA 

SS 

LA 

LA 

BALE 

DC 

LA 

A 

CH 



9,0(0,10) 

9,160(0,11) 

9 2 

9^158(0,11) 

2,44(0,10) 

3,12(9,10) 

.0,4(0,0) 

14,64(0,12) 

♦ 

15,224(15,0) 

* 

15,224(15,0) 

* 

X'00000002' 

A«0000008A' 

A'0000009A' 

* 

9,1(0,0) 

9,80(0,13) 

9,156(0,11) 

9,2 

0,0 

2,12(9,10) 

0,12(0,0) 

14,248(0,12) 
9,1 (0,0) 
9,80(0,13) 

9,168(0,11) 

12,228(15,0) 

* 

1,6(0,0) 

0,3(0,0) 

14,12 

A'00000000' 

3,796(0,10) 

0,3(0,0) 

1,3(0,0) 

14,12 

A'00000000' 

9,1(0,0) 

9,80(0,13) 

9,162(0,11) 

9,160(0,11) 

9 2 

3*596(9,10) 

4.4 

0,3(0,0) 

1,4(0,0) 

14,12 

A'00000000' 

9,1(0,0) 

9,80(0,13) 

9,16 2(0,11) 



2 — INTERHBTRICS 
SYKBOLIC OPERAND 

A 

H'4» 

H'16' 

E 
K 

V1SN 

OOOOEO LBL*9 

OOOOEO LBL#9 



DEKO 
DEKO 



INC 



PAGE 12 



H«12» 

K 
V16SN 



H'5« 
0000E4 



IOINIT 

MY STRUCTORE+740 



K21SNP 



H'3« 

H'4' 

KY STRUCTCRE+540 



H21SNP 
H«3« 



BU/S COMPILATION — PHASE 
LOCCTR CODE LABEL IKSN OPERANDS 



2 — IHTEEHETBICS, 
SYMBOLIC qPEBAND 



INC 
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000 164 

000168 

00016C 

00016E 

000172 

000 176 

000178 

00017C 

000180 

000182 

000186 

000 13A 

00013C 

000190 

000194 

000196 

00019A 

00019E 

000 UO 

0001A4 

001 A3 

0001AA 

0001 AE 

000132 

0001B4 

0001B8 

000 IRC 

0001C0 

0001C4 

000 1C8 

00 ICC 

0001CE 

000 1D2 

0001D6 

0001D8 

000 TDC 

0001EO 

0001E4 

0001E8 

0001EC 

000 1F0 

0001F2 

000 1F6 

0001FA 

0001FC 

000200 

000204 

000206 

00020A 

00020E 

000210 

■ 000214 

000214 

000290 

' 000290 



47CF0134 

7800A008 

05 EC 

00000000 

4130\02C 

1344 

41000001 

41100004 

05FC 

00000000 

7300A00C 

5EC 

00000000 

7900A010 

05EC 

0000000.0 

7800A014 

05EC 

00000000 

7800A018 

05EC 

00000000 

7800A01C 

05EC 

00000000 

41900001 

5090D050 

4C90B09C 

89900002 

4139A00C 

1B44 

41000003 

41100004 

05EC 

oooooooo 

41900001 

5A90D050 

4990 BO A8 

47CF01BC 

7800A020 

05EC 

00000000 

7800A024 

05 EC 

00000000 

7800A028 

052C 

00000000 

7800A02C 

05EC 

OOOOOOOO 



ST#27 



47F0C004 
47F0C174 



$DEMO 



BC 


12,308(15,0) 


000134 


LE 


0,8(0,10) 


D 


BALR 


14,12 




DC 


A'00000000' 


EOUT 


I- A 


3,44(0,10) 


E 


SB- 


4,4 




LA . 


0,1(0,0) 




LA 


1,4(0,0) 




BALR 


14,12 • 




DC 


A'00000000' 


M21SHP 


LE 


0,12(0,10) 


F 


BALE 


14,12 




DO- 


A'00000000' 


EOUT 


LE 


0,16(0,10) 


G 


BALE 


14,12 




DC 


A'OOOOOOOO' 


EOUT 


LE 


0,20(0,10) • 


H . 


BALE 


14,12 




DC 


A'OOOOOOOO' 


EOOT 


LE 


0,24(0,10) 


I 


BALE 


14,12 




DC 


A'00000000' 


SOOT 


LE 


0,28(0,10) 


J 


BALE 


14,12 




DC 


A'00000000' 


EOOT 


LA 


9,1(0,0) 




ST 


9,80(0,13) 




MH 


9,156(0,11) 


H'12' 


SLL 


9,2 




LA 


3,12(9,10) 


K 


SE 


4,4 




LA 


0,3(0,0) 




LA 


1,4(0,0) 




BALR 


14,12 




DC 


A'00000000' 


M21SS! 


LA 


9,1(0,0) 




A 


9,80(0,13) 




CH 


9,168(0,11) 


H*5' 


BC 


12,444(15,0) 


0001B 


LE 


0,32(0,10) 


L 


BALR 


14,12 




DC 


A'00000000* 


EOOT 


LE 


0,36(0,10) 


M 


BALR 


14,12 




DC 


A'00000000' 


EOOT 


LE 


0,40(0,10) 


N 


BALR 


14,12 




DC 


A'00000000' 


EOOT 


le : 


0,44(0,10) 





BALR 


14,12 




DC 


A'00000000' 


EOOT 


EQU 


* 




BC 


15,4(0,12) 




CSECT ESDID= 0003 




BC 


15,372(0,12) 


STEAC 



Eig. 3,4 (con't) 



HAL/S COMPILATION — PHASE 
LOCCTR CODE ' LABEL ISSN OPERANDS 



30310 


00000358 


30314 


00000358 


30318 


00000353 


0031C 


00000358 


00320 


00000353 


00324 


00000000 


00328 


00000001 


0032C 


OCOC 


0032E 


0010 


00330 


C004 


00 332 


0003 


00334 


0064 


00336 


00F8 


00338 


0005 


0033A 


UC3C1E2 


0033E 


C540E5C1 


00342 


D9C9C1C2 


00346 


D3C540D6 


0034A 


E4S340D6 


0034E 


C640D9C1 


00352 


D5C7C5 


*l 




H- 





DC 
DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

END 



A'00000358' 
A'00000358' 
A'00000358« 
A'00000358' 
A'00000358' 
• A'00000000' 
X'OOOOOOOT 
X'OOOC 
X'0010' 
X'0004' 
X'0003' 
X'0064» 
X'00F8» 
X'OOOS' 
X'1AC3C1E2' 
X'C540E5CT 
X'D9C9C1C2' 
X'D3C540D6» 
X'E4E340D6' 
X'C640D9CV 
X'D5C7C5' 



2 — INTERMETRICS, 
SYMBOLIC OPERAND 



INC 
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3DEM0 



OJ 



O 

3 



Fig. 3.4 Ccon't) 
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RLD ?OS EEF FLAG ADDRESS 



0001 


0008 


C8 


000211 


o'd.oi 


0008 


C8 


000207 


0001 


0008 


08 


0001FD 


00 01 


0008 


08 


000 1F3 


0001 


0007 


C8 


000 1D9 


0001 


0008 


08 


0001B5 


0001 


0008 


08 


0001AB 


0C01 


0008 


08 


0001A1 


0001 


0003 


C8 


000197 


0001 


0008 


08 


00018D 


0001 


0007 


08 


000183 


0001 


0008 


08 


00O16F 


0001 


0007 


C8 


000155 


0001 


0007 


08 


00012D 


0001 


0006 


08 


000119 


0001 


0001 


08 


0000DD 


0001 


0001 


ci 


0000D9 


0001 


0003 


OS 


00007F 


0001 


0003 


C8 


000005 


0002 


0003 


C8 


00021D 


0003 


0005 


C8 


000325 


0003 


0004 


C3 


000321 


0003 


0004 


08 


00031D 


0003 


0004 


08 


000319 


0003 


0004 


08 


000315 


0003 


0004 


ce 


000311 


LOC 


B DISP 


NAME 


UNDER DEMO 






000358 


A 000 




A 


00035A 


A 002 




B 


00035C 


A 004 




C 


000360 


A 008 




D 


000364 


A 00C 




F 


000368 


A 010 




G 


000388 


A 02C 




E 


00036C 


A 014 




H 


000370 


A 018 




I 


000374 


A 01 C 




J 


000393 


A 0.0C 




K 


000378 


A 020 




L 


000 37 C 


A 024 




« 


OC0380 


A 028 




N 


000384 


A 02C 







000488 


A 038 




HY_STRUCTaRE 


UXDEB PE0C1 




000353 


A 006 




A 



2 33 LINES OF AESTRACT CODE CONVERTED 
856 BYTES 0? PROGRAM, 1544 BYTES OF DATA 



Fig, 3.4 (con't) 
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MAX. INDIRECT STACK SIZE -7 

2ND INDIRECT STACX SIZE =} 

NUMBER OF STATEMENT LABELS USED -18 
MAX. STORAGE DESCRIPTOR STACK SIZE =2 
END STORAGE DESCRIPTOR STACK SIZE =1 
NUMBER OP MIKOE COMPACTIFIES • =1 
NUMBER OF MAJOR COMPACTIFIES . =0 



END OF HAL/S PHASE 2 OCTOBER 9, 
TOTAL ELAPSED TIME IN PHASE 2 
ELAPSED PHASE 2 SET UP TIME 
ELAPSED PHASE 2 GENERATION TIME 
ELAPSED PHASE 2 CLEAN-UP TIME 



1973. CLOCK TIME 
0:0:10.80 
0:0:0.08 
0:0:3.35 
0:0:7.37 



11:53:41.45 






* 



o 
o 

3 



Fig. 3.4 (con't) 



ft. DEBUGGING AIDS 



ft.1 Compilation Errors 



4.1.1 Message Format 

When Phase 1 of the HAL/S compiler (the syntax 
checking phased detects an error condition, a diagnostic 
Message is placed in the primary source listing at the 
pofnt of detection. These error messages have the 
following form: 

***** c ERROR #n OF SEVERITY S. ***** . 

#**## text of message 

In this message: 

c = mnemonic error name uniguely identifying 
this error message (see Sec. 4.1.2) 

n = indication that this is the nth error in the 
current compilation < 

s = severity of error (see Sec. 4.1.3) 

For error messages other than the first in a given 
compilation, the following line is place d J^er all error 
messages referring to a particular HAL/S statement. 

***** LAST ERROR WAS DETECTED AT STATEHENT m ***** 

where m is the HAL/S statement number of the most recent 
previous statement that received an error message. 

ft. 1. 2 Classification Scheme 

Each error message that may be generated by Phase 1 
of the HAL/S compiler has a unique mnemonic designation 
which appears in the error printout. These mnemonics have 

a according to general error-type classes 
ThPfirs letter of each error message mnemonic indicates 
lit maifr class to which the error belongs (see Appendix 
m The second letter, if present, indicates a sun class 
father describing the error. These one or two letters 
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are followed by a number which simply indicates members of 
a class-subclass group. The table at the beginning of 
Appendix D shows the meaning of the possible letter 
combinations. 

4.1.3 Error Severity 

The severity indication in the error message shows 
the effect of the error on the compilation process. The 
possible severities and their effects are as follows: 

= warning (compilation proceeds normally) 

1 = error (compilation proceeds, execution prevented) 

2 = severe error (syntax check continues, 

code generation prevented) 

>2 = abortive error (compilation halts immediately) 

4.1.4 Phase I Error Summary 

Hear the end of the Phase I source listing and table 
printout, a summary of detected errors is printed in the 
following form. 

END OF HAL/S PHASE 1, <date>. CLOCK TIME = <tirae> 
n CABDS HEBE PROCESSED. 

X ERRORS WERE DETECTED. THE MAXIMOM SEVERITY HAS y. 
' THE LAST ERROR DETECTED HAS AT STATEMENT Z. 

***** SUMMARY OF ERRORS DETECTED IN PHASE 1 ***** 

ERROR #1 AT STATEMENT e1 OF SEVERITY s1 

ERROR #2 AT STATEMENT e2 OF SEVERITY s2 



4.1.5 Phase II Errors 

Phase II of the HAL/S compiler (the code generation 
phase) may also produce some error messages (see Sec. 
3.6). These messages have the form: 

*** ERROR #1 DURING CONVERSION OF HAL/S STATEMENT n 
text of message 
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tthprp n is the HAL/S compiler-assigned statement number to 
the compilation. 



U.2 Execution Errors 

U. 2.1 Introduction 

'This section describes ho. error handling ha s been 

are two classes of errors: 

and are signalled internally; 

ii) user-defined errors, (75-100) which are signalled by 
the user through a SEND EHRORn statement. 

System-defined errors may also be signalled by the user 
through a SEND EHRORn statement. 

The HAL/S Error Processor processes all errors and 

- f s J?-ss b? l^aws 

IGNORE statement! These three Possible actions mil be 
referred to as GO TO action, SYSTEM action, and IGNORE 
action respectively. 

In the following sections, the error format given 
shows'the'mLimum information printed If the compile time 
TRACE option is not in effect then there will be no 
information on the statement number of the last HAL/S 
statement to be fully executed. 

4.2.2 GO TO Action 
(to be supplied later) 

4.2.3 SYSTEM Action 

One of three possible SYSTEM actions may ensue: 
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UNLIMITED' - The standard fixup for EHBOEn is taken 
and the following message is printed: 

***** HAL EEEOR n - (message) — > (location) 

LAST STATEMENT HAS m 

STANDARD FIXUP, EXECUTION RESUMED 

where (message) is the error text corresponding 
to ERRORn. The last HAL/S statement to be fully 
executed is specified by m and the address of 
the error is specified by (location) . Following 
this, the Error Processor returns control to the 
user's program. 

LIMITED - The error count for ERRORn is updated. 
If it equals or exceeds a user-set maximum count 
(refer to the the ERRORLIM option in Appendix B. 
- note that this is applied to all LIMITED type 
errors for which SYSTEM action is specified), 
the following message is printed: 

***** HAL ERROR n - (message) — > (location) 

LAST STATEMENT WAS m 
ERROR COUNT EXCEEDED 

and execution of the user's program abnormally 
terminates. 

Otherwise, if the maximum count is not 
exceeded, the standard fixup for ERRORn is taken 
and the following message is printed: 

***** HAL ERROR n - (message) — > (location) 

LAST STATEMENT WAS m 

STANDARD FIXDP, EXECUTION RESUMED 

and the Error Processor returns control to the 
user*s program. 

In both cases, (message) is the text for 
ERRORn, (location) is the address where the 
error occurred, and m is the last HAL/S 
statement to be fully executed. 

TERMINATE - The following message is printed: 

***** HAL ERROR n - (message) — > (location) 

LAST STATEMENT WAS ra 
SYSTEM ACTION IS TERMINATE 

where (message) is the text for ERRORn, 
(location) is the address where the error 
occurred, and m is the last HAL/S statement to 
be fully executed. Following this, execution of 
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the user's program abnormally terminates. 

Note that the form of the SYSTEM action and 
standard fixup is specified for each error message 
in Appendix E. 

4.2.1 I G HO RE Action 
(to be supplied later) 
4.2.5 The Error Summary 

Whether execution terminates normally or abnormally, 
if there were any errors signalled either internally or by 
the user, a summary in the following form is printed on 
the output channel defined by the MCHAN RONPARM option 
(see Appendix B) : 

*** SUMMARY OF ERRORS *** 

ERROR n1 OCCURRED r1 TIMES 

ERROR n2 OCCURRED r2 TIMES 



4.3 Execution Dumps and Traces. 
4.3.1 What is Available 



4.3.1.1 TRACE. For debugging runs, the HAL/S 
compiler can supply checkpoints in the compiled 
code at each executable statement. The "TRACE" 
compiler option provides this facility. Any 
program compiled with the TRACE option can take 
advantage of any of these execution- time options: 

a) A running trace indicating the current statement 

number being executed. 

b) A selective statement number trace, which can 

either be used to monitor a program segment 
or, alternatively, to isolate heavily used 
program segments such as large DO FOB loops, 
which could produce a large number of repeated 
trace points. 

c) A back trace of the last N statements executed 

prior to program termination, where N is 
specified by the user. 
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a) A trace of block invocations and returns. 

4-3.1.2 DUMP. The HAL/S system provides a readable 
dump of all program variables upon abnormal 
termination of any program. Program variable names, 
rather than machine addresses, are used to identify 
the items contained in the dump. The declaration 
type of the variables determines their appearance 
in the printout: matrices are printed in matrix 
form, character strings are printed as strings and 
integers and scalars are printed in decimal form; 
only bit variables are dumped in hexadecimal 
notation. This dump can be of significant value in 
determining the cause of program failure. The 
features available in using the DDMP facility are 
as follows: 

a) Optional full program dump upon abnormal 
termination of a program. 



b) Optional full program dump given at program 
termination whether normal or abnormal. 



c) A full program variable dump at selected 
statement numbers. 



d) Block label (PROGRAH, TASK, UPDATE, PROCEDURE, 
FUNCTION) dumps at selected statement numbers. 

4.3.1.3 Location of TRACE and DUMP output. The 
TRACE output is directed to the same HAL/S output 
channel as error messages. The output normally goes 
to a printer file (SYSOUT=A) and appears 
interleaved with any program-induced output on that 
channel. The output channel number is optionally 
specified by the MCHAN execution time parameter. 
The DUMP output is directed to the file 
designated by the HALDUMP DD card which is normally 
defined as a printer file (SYSOUT=A) . Note that 
this output is not interlisted with any HAL/S 
program output. 

4.3.2 Invoking the TRACE Facility 

4.3.2.1 Compile Time Parameters. To allow a program 
to use the execution time tracing facilities for 
statement tracing or back tracing (see appendix B 
for the run time options needed to invoke these 
forms of tracing) the program must be compiled with 
the TRACE option specified in the PARM field of the 
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compilation-step JCL. When using the catalogued 
procedure HALSCLG, this is accomplished by coding 
the option in the option parameter of the 
invocation step: 

//ANYNAME EXEC HALSCLG, OPTION=» TRACE, <other compile 
options>' ,<other JCL options> 

4.3.2.2 Execution Time Parameters. A program may 
specify execution time reguests for trace output. 
The various forms of these TRACE reguests are 
listed in appendix B. 

A statement back trace always appears if a 
program terminates abnormally. The user may 
optionally call for a back trace on a normal 
termination by specifying the MSGLEVEL run time 
option to be greater than 0. The HISTORY Option may 
be used to specify the number of statements to be 
backtraced. 

These reguests are placed in the PARM field of 
the step which executes the HAL/S program. When 
using the HALSCLG catalogued procedure, this is 
accomplished by coding the reguests in the RUNPARM 
parameter of the invocation step: 

//ANYNAME EXEC HALSCLG, OPTION=« TRACE, <Other compile 
options>',Ru-NPARH='TRACE=1,HIST0RY=20,<other execution 
options> f ,<other JCL options> 



4.3.3 TRACE Output 

When the TRACE function is triggered by the end of 
execution of a HAL/S statement for which a trace reguest 
was in effect, the following message appears on the 
defined output channel. 

STATEMENT n /; 

where n is the number of the source statement being 
traced, and whose execution has just finished. 

The form of the statement back trace is illustrated 
in the following example: 

STATEMENT HISTORY, PROM OLD TO NEW: 19 24 25 27 



4. 3. 4 Invoking the DUMP Facility 

4.3.4.1 Compile Time Parameters. To utilize 
features (a) and (b) of Section 4.3.1.2, no compile 
time options are required. To utilize features (c) 
and (d) of that section, the TRACE option must be 
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specified as noted in Section 4.3.2.1. 

4 3 4 2 Execution Time Parameters. The user may 
request DUMP output in one of three forms as 
specified in appendix B. These DUMP requests are 
placed in the PARM field of the step which executes 
the HAL/S program. The method used to specify these 
options when invoking the HALSCLG catalogued 
procedure is identical to that for specifying the 
TRACE options (see Section 4.3.2.2). 

4.3.5 DUMP Output 

'when the DUHP function is triggered, DUMP output is 
placed on the file defined by the HALDOMP DD card. The 
DUMP output for each block of code of the user <s program 
begins on a new page with a header of the form: 

VARIABLES DEFINED UNDER <block> <name> 

where <biock> may be PROGRAH, PROCEDURE, TASK, FUNCTION, 
UPDATE, or COSPOOL and <name> is the name of the block. 

Note that this definition of "variables defined 
within the block" means only those variables at the nest 
level of the block. Variables defined in blocks which are 
nested within the current block are not dumped with the 
outer enclosing block, but instead are dumped with the 
block in which they are actually declared. 

Each variable dumped is identified by a line in the 
dump of the form: 

<name> <type> <other information> 

where <name> is the HAL/S name of the variable and <type> 
Is the type of the variable. The <other information> 
field is filled with any pertinent facts about the named 
variable such as ARRAY information. A sample dump format 
is shown in Figure 

The <name> <type> line is followed by the actual 
value of the variable, printed in the format required by 
the type and size of each individual variable. 

4.3.6 Abnormal Termination 

If a HAL/S program terminates abnormally, the 
following information is output on the error message 
channel: 
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VARIABLES DEFINED UNDER PROGRAM INVERSER 



1, -1.5582966E+60 

2, -1.3303539E+68 

3, 2.5098037E-01 



B MATRIX (3,3) 
2.5098037E-01 
-6.7664175E+66 
2.5098037E-01 



-4.6712099E+27 
2.5098037E-01 
2.5098037E-01 







A MATRIX (3,3) 






If 


0.0 


0.0 


0.0 




2, 


0.0 


0.0 


3. 0000000E+00 




3, 


0.0 


3.0000000E+00 

C MATRIX (3,3) 


0.0 




1, 


2.5120925E-01 


9.4509822E-01 


2.5098037E-01 




2, 


2.5098037E-01 


9.7636336E-01 


2.5099140E-01 




3, 


-1.5269125E+60 


2.5098037E-01 

M MATRIX (3,4) 


2.5329500E-01 




1, 


3 . 00000OOE+0O 


3.0000000E+00 


3. OOOOOOOE+OO 


1. 0000000E+00 


2, 


3.0000000E+00 


3. 000000 OE+00 


3. 0000000E+00 


0.0 


3, 


3. OOOOOOOE+OO 


3.0000000E+00 

N MATRIX (3,4) 


3. 0000000E+00 


0.0 


It 


1. OOOOOOOE+OO 


2 . OOOOOOOE+OO 


3 . OOOOOOOE+OO 


4. 0000000E+00 


2, 


4.0000000E+00 


4 . OOOOOOOE+00 


1.5000000E+00 


1.5000000E+00 


3, 


1.5000000E+00 


-1.1999998E+00 

MT MATRIX (4,3) 


8.7999992E+00 


0.0 


1, 


0.0 


0.0 


0.0 




2, 


0.0 


0.0 


3. 0000000E+00 




3, 


0.0 


3. OOOOOOOE+OO 


0.0 




4, 


2.5098037E-01 
5 


2.5098037E-01 
I INTEGER 
T INTEGER 


2.5098037E-01 





The following message indicating the occurrence of the dump is output on the error 

message .channel : 



HAL VARIABLE DUMP WRITTEN TO DD CARD HALDUMP 



Figure 4-1. 
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! 



SYSTEM 

ABEND CODE nnnn IN <nane>, ENTRY=dddddddd 

USER 



ABEND — > AT dddddd. 



LAST STATEMENT WAS n 



! LIBRARY (<membername>) 
INTRINSICS 
<prograra block name> 
UNKNOWN ADDRESS 



The above may be followed by TRACE ana DUMP 
information and by a summary of run time errors. 

4 The following comments are useful in interpreting the 
above information: 

a) <name> is the member name of the loa3 module 
being executed. 

b) ENTRY=aaddaaaa is the absolute address of the 
entry point into the moaule. 

c) ABEND — > AT dddddd gives the absolute 
adaress where execution terminated abnormally. 

d) UNKNOWN ADDRESS appears if the ABEND aaaress 

aoes not lie within the bounds of the area occupied 
by the program. 

e) +aaa inaicates the ABEND aaaress relative to 
the start of the program segment specifiea. 

f) LIBRARY (<membername>) appears if the abnormal 
termination was in the runtime library. 

g) INTRINSICS appears if the abnormal termination 
was in an intrinsic function. 

h) If the abnormal termination was in the object 

code of the user program, then <program block name> 
gives the name of the block where the ABEND occurred 

i) Appendix F gives a list of user abend codes. System 
abend codes are those characteristic of OS/360. 
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5. HAL/S REALTIME PROGRAMS 
(to be supplied) 
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7 characters of the HAL/S name. Therefore, care 
should 1 be exercised in naming programs so that 
unigue names will be generated. 

b) ftny occurrence of the underscore character (^J 
in the first 7 characters of a PROGRAM, 
PROCEDURE, FUNCTION, TASK, or COMPOOL is 
eliminated. The resulting characters are joined 
together to produce the name given to the 
control section which is created, (e.g. A— B— C 
becomes ABC) . An additional character ($) is 
placed on the front of the resultant name to 
form the final name. 

6.2.7 The INCLUDE Compiler Directive 

Use of the INCLUDE compiler directive to 
access a symbolic library has been implemented in 
the following way. The name found on the INCLUDE 
directive such as: 

INCLUDE COSPOOLA 



will be used to search the symbolic library. The 
name must be a 1 to 8 character string beginning 
with a letter. 

The symbolic library must be defined by the 
following JCL: 

//HAL. INCLUDE DD DSN=<library name>,<other parameters> 

The <library name> must be the data set name of the 
library. The library data set must have partitioned 
organization and must be referred to in the JCL by 
data set name only (DSN-HAL. LIB) , not as data set 
and member name (DSN=HAL.LIB (COMPOOLA) ) . 

The library thus defined is searched for a 
member whose name is exactly the name found on the 
INCLUDE directive. The library must contain 80 
character card images but may be blocked in any 
legal manner. Two or more libraries may be 
concatenated in the JCL if they conform to; the 
standard JCL rules for for such concatenation. 

6.3 Execution Time Characteristics 

6.3.1 Input/Output 

a) The I/O device defined to be the error message 
channel (CHANNEL6 is the default) is forced to 
have record format FA or FBA. 
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b) Numeric formatting of output items is done as 
follows: 



integers - 



single 
precision 
scalars - 



an 11-character 
field is printed 
right justified. A 
sign is added if 
negative. 



with the number 
floating minus 
the number is 



a 14-character field 
follows: 



is printed as 



sx. xxxxxxxE+txx 



where s is a blank or minus sign 
x is a single digit to 9 
t is a plus or minus sign 

double 
precision 

scalars - a 23 character field is generated as 
follows: 

sx . xxxxxxxxxxxxxxxxEtxx 



c) If not specified through JCL, the HAL/5 I/O 
routines will assume a logical record length of 
80 for unpaged output devices and a logical 
record length of 133 for paged output devices. 
The first character of the 133 character paged 
output record is assumed to be an ASA carriage 
control character. 
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APPENDIX A. 



Ccmpilo-Tiiue JCL Options 

The following is a list of options which may be coded in 
the "OPTICN=" field of the JCL invoking the HAL/S compiler. 

LISTTNG2 - Causes unformatted source listing 

to be generated 

DtjMp - Bequests the compiler to produce a memory 

dump if certain internal compiler errors 
occur 

PAG3S=n - Sets the maximum page number to be 

allowed in generation of the primary 
compilation listing to n. The default 
is 250 pages. 

LIST - Produces an assembly listing from PHASE II 

of the compiler 

TRACE - Causes the generation of statement tracing 

code in the object module 
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APPENDIX B. 



Execution-^ime JCL Options 

The following is a list of options which may be coded in 

the "RUNPAPT^" field of the .TCL invoking the HAL/S compiler. 

This information is directed to the "PAFM" field of the 
execution step. 

TAB=n : Specifies the automatic spacing between elements 

on output. The default value is 5. 

LINES=n : Specifies the number of lines per page of paged 

output. The default value is 55 lines. 

HISTORY-n : Specifier, the number of HALS statements recorded 

in the circular history buffer (minimum is 10) 
The default value is 100 statements. 

HCHAN=n : Specifies the channel number (DD card CHANNELn) on 

which error and trace messages appear. The valid 
range is 0-9; CHANNELS is the default. 

TEACE=0 : Specifies no tracing (default option) 

TBACE=1 : Statement tracing 

(Note that this option is valid only if 'TBACE' 
was specified on the compilation) 

TRACE=2 : Procedure & function call and return tracing 

TRAC2=3 : Statement, procedure ?, function call, and return tracing 

DUMP=0 : No HAL/5 variables dumped 

P!T?'~=1 : HAL/S variables dumped on J\EENC (default option) 

DUMP=2 : same as DUMP=1 but also on normal end 

(Note that DD cards HALSYMB and HALDU1P are required) 
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MSGLEVEL=0 : no backtrace on normal termination 

(this is the default value) 

MSGLEVEL=1 : backtrace occurs on normal termination 

FPROELIM=n : specifies the maximum number of execution time 
EEROELIM sp^ rs aiiowefl ^ ^^ Va i U !/\^' s ^? EK 

maximum is 254; if 255 is specified, the SYSTEM 

action will be ONLIMITED. 
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APPENDIX C. 



Prototype Catalogued Procedures 



This Appendix shows five examples of the form of 
catalogued procedures needed to compile, link edit and execute 
a HAL/S proqram. The five procedures perform varying degrees 
of processing. The procedure names and their uses are: 



HALSC Compile a HAL/S program 

HALSCL Compile and link a HAL/S program 

HALSCLG Compile, link, and execute a HAL/S program 

HALSL Link a previously compiled HAL/S program 

HALSLG Link and execute a previously compiled 
HAL/S program 

The most complex procedure, HALSCLG, is described line by line. 

The following comments apply to the prototype catalogued 
procedure HALSCLG listed in this appendix. The comments 
generally apply equally to either of the other procedures. 



Line 10000 - 



This PPOC statement names the procedure and 
defines the symbolic parameters. The 
OPTION and BHNPABH parameters are the means 
of supplying optional information to the 
compiler and run-time system respectively. 



Lines 10100 - 

10200 



The name of the compilation step is HAL. 
The name of the actual program to be 
executed is MONITOR. MONITOR handles all 
compiler/OS interfaces and also performs 
the actual loading and overlaying of the 
two phases of the compiler. The compiler 
requires a 300K reqion. A larger region 
may be specified. Tho compiler will always 
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use all the memory it is given. A larger 
region will generally result in smaller 
compilation times. A default time limit of 
1 minute is supplied. This is sufficient 
for most average size HAL/S programs 
(approx. 300 HAL/S statements). 

The PABM field contains the compile-time 
options. The OPTION field receives any 
user-specified options. 



Line 10300 - The STEPLIB DD card specifies the location 

of the load module library which contains 
the module EONITOR needed to run the 
compiler. This card may define any direct 
access library which contains the proper 
module or may be deleted at installations 
where the module has been made part of the 
system library (SYS1.LINKLIB) . 



Lines 10U00 - The PROGRAM DD card defines the phases of 
10500 the compiler that are to be used. The two 

phases are specified as catenated DD cards. 
The first DD card specifies tha name and 
location of the syntax analysis phase. The 
second DD card specifies the name and 
location of the code generation phase. 
These two data sets have DCB's of the form: 

DCB=<FECFN=?,LRECL=7200,3LKSIZE=7200) 

and may reside on direct access or magnetic 
tape. It is recommended, however, that 
direct access be used. 



Line 10600 - The SYSPRINT DD card defines the primary 

listing data set. This is generally 
assigned to a system output class, but may 
be associated with any sequential data set 
with the proper characteristics. The 
record format must be FA or FBA with a 
logical record length of 133 and any 
appropriate block size. If not supplied in 
the JCL, the DCB will default to 

DCB={PSCFM=FBA,LRECL=133,BLKSIZE=7182) 
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Line 10700 - The LISTING2 DD card defines the secondary 

listing data set. It may define a system 
output class or any sequential data set. 
The DCB requirements are the same as for 
SYSPBIKT. 



Lines 10300 - The OUTPUT 3 DD card defines the data set 
11000 which is to receive object code which is 

produced by the compiler. Tr the prototype 
procedure, this data set is given a 
temporary Name (SSHALOBJ) and is passed 
(DISP=(M0D,PAS5) ) to subsequent steps. 

Since this data set contains card images, 
it must have a loqical record length of 80 
and a record format of F or FB. The 
blocking factor may be any legal multiple 
of 80. If no DCB information is supplied 
in the JCL, the default will be 
DCB=(RECFH=FB # LRECL=80,BLKSIZE=7200). This 
DD card may specify a direct access, 
magnetic tape, or unit record device. 



Lines 11100 - The 0UTPUT5 DD card defines the data set 
11200 which will receive the DUFIP/TPECE mapping 

file. This file allows the execution- time 
DUMP and TRACE facilities to associate 
memory locations with HAL/S variable names. 
For the compile-load-go type of run this 
data set is generally a temporary one which 
exists only for the duration of the job. 
However, if the results of a given 
compilation are saved to be executed many 
times without recompile t ion, the PUEP/TRACE 
mapping file should be saved as well. 

The 0UTPUT5 DD card must define a 
partitioned data set. The SPACE parameters 
used in the prototype procedure are more 
than adequate to contain the- mapping- file 
of any one HAL/S program. If a permanent 
file is to be used to save the mapping 
files of several HAL/S programs, the SPACE 
requirements should be based on the 
expectation of one 40 byte logical record 
pec symbol table entry. 

The OUTPUTS DD card is accessed during the 
code generation phase of the compilation. 
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One member of the partitioned data set is 
created for a compilation unit. The name 
of the member is the first 8 characters 
of the name of the Program or Procedure 
being compiled, padded with blanks if 
necessary. 

If a member with the desired name does not 
exist at compile-time, one is created. If 
a member with the desired name already 
exists, it is replaced by the new member. 

The use of a permanent partitioned data set 
makes it possible to maintain a "library" 
of mapping files, with tha member names 
uniquely specifying the HAL/3 compilations 
to which the maps may be applied. 

Tha format of the file must have a logical 
record length of 40 and a record format of 
FB. If DCB information is omitted, the 
default is 

DCB=(BECFM=FB,LRECL=40,BLKSIZE=400) 



Line 11300 - The EBBOB. DD card defines the partitioned 

data set which contains the error message 
texts used by the syntax analysis phase of 
HAL/S. This data set is supplied with the 
compiler and, being a partitioned data set, 
must reside on a direct access volume. 



Lines 11400 - The FILE1, FILE2 and FILE3 DD cards specify 
1 1600 work files. These files are used for 

interphase communication. The device may 
be either direct access or magnetic tape. 
Space equivalent to approximately 60 tracks 
on a 2314 should be available for each DD 
card. The DCB is internally specified as 

DCB=(BECFM=F,LBECL=7200,BLKSIZE=7200) 

Line 11700 - The SYSODTJKP DD card specifies the location 

to which an abend dump is to be sent in the 
event that the compiler terminates 
abnormally. 



Lines 2C000 - These lin^s define the data sets necessary 
21200 to allow the external references in the 
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obiect program to be resolved and prepare 
the program for loading into memory. The 
JCL is the standard required by the OS/360 
Linkage Editor plus that which is necessary 
for execution of the HALLINK processing 
program. Details of the use of individual 
DD cards may be found in the IBM 
Linkage-Editor and Loader manual. The only 
feature of this JCL which is peculiar to a 
HAL/S compilation is the form of the SYSLIB 
DD card and the addition of the STACKOBJ 
and TEMPLOAD DD cards. These two 
additional DD cards should be used as 
specified in the procedures. They serve as 
intermediate work data sets for the HALLINK 
program. 

The SYSP3INT DD card should always 
have a BLKSIZE parameter specified in the 
JCL. The BLKSIZE may be any value which is 
acceptable to the OS/360 Linkage Editor. 

The HAL/S runtime library package must 
be the primary source of modules to resolve 
external references. Any references which 
cannot be resolved from the HAL/S library 
will be resolved from any libraries 
catenated to the first DD card. 

If the user has any HAL/S program 
references to user-written non-HAL/S 
subprograms or to previously compiled HAL/S 
programs, it is at this point that the 
programs must be supplied to the linking 
process. This may be done through the use 
of a catenated DD card specifying a user 
library, or by direct user input of control 
cards to the link editor. 



Lines 30000 - These cards specify the execution of the 
30200 load module created in the LKED step. 

The parameter • RtfNPARM* causes any user- 
supplied runtime parameter to be made 
available to the running program. 



Line 30300 - CHANNEL6 DD card is supplied in the catalo- 
gued procedure because device 6 is commonly 
used as an output unit. It is also supplied 
because the HAL/S execution-time error 
handling system requires CHANNEL6 for 
message listings. The user may specify 
(via the RHNPARM keyword) that the runtime 
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error messages be sent to a different 
channel. 



Tine 30400 - The HALDUMP DD card defines tne data set 
Line Junuu ^ receivQ the DlJMP otlt p U ts that result 

from user requests or abnormal termination. 
The data set attributes are internally 
defined to be 



DCB=(EECFK=FBA f LEECL=120 r BLKSIZE=7200) 



Tine 30500 - The HAISYMB DD card defines the partitioned 
line 30500 data s ^ wbich CQntains the dump/tBACE 

mapping file for the proqrara being 
executed. In the case of the prototype 
procedure, this is the temporary data set 
created by the compilation step as OUTPUTS. 

The discussion of the 0UTPUT5 DD card above 
mentions the use of a permanent library of 
mapping files. Such a library would be 
identified in the HALSYMB DD card. 



Tine 30600 - The CHANNEL5 DD card has been supplied in 
L the catalogued procedures because it is 

common practice to assume the device 5 will 
be used for input. The use of the DDNAKE 
parameter on the CHANNEL5 DD card allows 
the user to specify either 

//GO. CHANNELS DD <parameters> 

or 

//GO.SYSIN DD <parameters> 

to define the run-time input. 



T :„ p 30700 - The SYSUDUMP DD card specifies the location 
Line ju/uu ^^ a hexadecimal memory dump in the event 

of a program abnormal termination. 



Other User-Defined Execution-Time JCL 

The user may require additional exectuion time JCL to service 
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his proqram*s requirements: 

additional HAL/S data sets (other than the CHANNEL5 and 
CHANNEL6 supplied in the procedure) . These are data sets 
with names CHANNELn where n is in the range to 9. These 
data sets are referenced by HAL/S • I/O statements 
specifying the proper n as their device number (e.g. 
WHITE (8) references DD card CHANNEL8) . 

The HAL/S I/O routines make some assumptions about the 
characteristics of the data sets which are allocated to 
the various CHANNELn DD cards. These assumptions, along 
with a description of devices and organizations supported 
by HAL/S are detailed below. 

The user may supply any, all, or none of the DCB 
attributes for CHANNELn DD cards. The record formats 
which are acceptable to HAL/S are: 

F FB FA FBA FBSA 

V VB VA VBA 

17 UA 

Machine carriage control is acceptable but subject to 
interpretation described below. 



General Rules Hsed by HAL/S to Create DCB Attributes 



a. BLKSIZE not supplied (by JCL or data set) . 

The maximum block size of the particular device is found. 
The BLKSIZE is set to the largest multiple of LEECL which 
is less than or egual to this block size. Note that for 
tapes this maximum size is 32767 bytes which would require 
a sizeable buffer area to be taken out of main storage. 



LRECL not supplied. For PBINT files the IRE.CL 

defaults to 133. For non-PFINT files the default is 80. 



c. RSCFFI not supplied. For PRINT files the RECFN 

defaults to FBA. For non-PRINT files the default is FB. 



General Rules Governing HAL/S Sequential Output 

a. If the mode is PRINT and the DCBPECFM specifies 

"A", carriage control characters will be automatically 

C-7 



generated. For "H" on PAGED devices, it is the user's 
responsibility to see that the first character of each 
output line has the proper control characters. For UNPAGED 
devices, control characters are not allowed. 



b. Variable length record specification will cause 

records to be written in variable format. However, the 
records will actually be all the same length (LEECL) . 

c. Format records (undefined rocord format) 

will be written in the proper form, but all records will 
be the same length (LEECL) . 

General Rules Governing HAL/S Sequential Input 

a. Carriage control characters encountered during 

input will be available to the programmer; i.e. scanning 
of the input will begin at the carriage control character. 

b„ Variable length records may be read. 

The 4 byte descriptor field of each record will not be 
available to the programmer. The effective length of a 
variable record will be "length read minus 4" (subject to 
further modification due to carriage control). 
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//HALSCL 
//HAL 

// 

//STEPLIB 
//PROGRAM 

// 

//SYSPRIHT 

//LISTING2 

//OUTPUT3 

// 

// 

//OUTPUT 5 

// • 

//ERROR 

//FIL21 

//FILE 2 

//FILE3 

//SYSUDUMP 

//LKED 

// 

//STEP LI 3 
//SYSPP.INT 
//SYSLI3 
//SYSLIN 

// 

//SYSLMOD 

// 

//SYSDT1 

//STACKOBJ 
//TEMPLOAD 
// 



The Catalogued Procedure HALSCL 

PROC CPTION= 

EXEC PGM=MONITOP,REGIOK=300K,TIME=1, 

PAR*1=»S OPTION' 

DISP=SHR,DSN=HALS360. MONITOR 
DISP=SHR,DSN=HALS3 60.PHASE1 
DISP=SHP,DSN=HALS360.PHASE2 

SYSOU" , = A,DCB= (?.SCFK=FBA,LRECL=13 3,BLKSIZE=3458) 
SYS0UT = A,DC3=(PECF?1=FBA,LRECL=133,BLKSIZE=3458) 
UNIT=SYSDA,DISP=(MOD, PASS) ,SPACE= (CYL, (1,1)) , 
CCB= (RECFK=FB,LPECL=80,BLKSIZE=400) , 

DSN=S&HALOBJ -.-,-,-»» 

D T S° = (MOD, PASS) ,DSN = SSHAI.SYMB,SPACE=(TRK, (2,2,1)) , 
DCB=(BECFK=FB,LRECL=40,BLKSIZE=400) ,ONIT=SYSDA 
DISP=SHR f BSN=HALS3 60.ERF.ORLIB 
UNIT=SYSDA,SPACE=(CYL, (3)) 
UNIT=SYSDA,SPACE=(CYL, (3)) 
UNT.T=SYSDA,SPACE= (CYL, (3) ) 

SYSOOT=A 
EXEC PGM=HALLINK,BEGION=100K,PARH=(LIST,KAP>, 

COND=(0,LT,HAL) 
DISP=SHR,DSN=HALS 3 60. MONITOR 

S YSOUT= A , DCB=3LKS IZE= 1 57 3 

DSN=HALS3 60.F.UNLIB,DISP=SHR 

DISP= (OLD,DEIETE) , DSN=S£HALOBJ 

DDNA«E=SYSIN 

DSN=5SHALMOD(GO) , DISP= { , PASS) ,OSIT=SYSDA, 

SPACE=(CYL,'(l'l)')»USIT=(SYSDA,SEP=(SYSLIll,SYSLHOD)) 

SPACE=(TRK, (5,10) ), ,UUIT=SYSDA 
DIS D ={NEH,PASS) ,DSN=&STE«P(TEMPNAKE), 
SPACE= (T3K, (20,20, 1) ) ,UNIT=SYSDA 



DD 
DD 
DD 
DD 
DD 
DD 



DD 

DD 
DD 
DD 
DD 
DD 



DD 
DD 
DD 
DD 
DD 
DD 

DD 
DD 
DD 



00010000 

00010100 

00010200. 

00010300 

00010400 

00010500 

00010600 

00010700 

00010800 

00010900 

00011000 

00011100 

00011200 

00011300 

00011400 

00011500 

00011600 

00011700 

00020000 

00020100 

00020200 

00020300 

00020400 

00020500 

00020600 

00020700 

00020800 

00020900 

00021000 

00021100 

00021200 
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The Catalogued Procedure HALSC 



//!!ALSC proc optio;.'= oooinnoo 

//!!AL EXEC Pni!=MOt!ITOR, REG IOf!=300K / T I ME=1, 00020000 

// PARi^'aOPTIOn' 00030000 

//STEPLIR DD DISP=S!in,D°,r:=i:AI.S3G0.nn'!|TOP. ' OOObOOOO 

//PROGRAM PD niSP=S!iR,ns:!=HALS3Gn.P!!Ar>El 00050000 

// DD DI5P=SIIR,Dr,?!=!lAL53G0.P!:ArE2 OOOf^OOO 

//SYSPRIMT PD. SY3nUT=A,DCn=(R.':CF!-=FPA,LP' T CL=135,'?L!'r;i v E=3t>Gr?) 0007000O 

//LISTK!G2 DD SYS0UT=A, RCP= (RECFM=FPA, L"EC1.=133, PLK5" I ZE=3'^H) OOOSOOrtp 

//OHTPUT3 DD U[IIT=CYSPA,DICP==(MOP,PASr),SPAn-E=(C"L,(l,l)), 00000000 

// nCB=(RECFI;=FR / LP.ECL=SO / PL!'.niZE=! l OO) / 00100000 

// DSJ!=ft&!!AI.OBJ • 00110000 

//OUTPUTS DD DISP=(ron,PASS),Dr;!=rn":i T 'l.rYr'P / C n ACE=(TP!' / (2,2,1)5, 001200O" 

// DCB=(RECF 1 ''=F3,L n rCL = i;0 / PL!'r]7E=lt"0),(1*!IT=PYGPA 01 300 no 

//ERROR DD PISP=SHP,PS r !=l!ALS3G0.EPP,PP.LIB 00U000O 

//FILE1 DD U:ilT=SY5r>A,SPACE=(CYL,(3)) 00150000 

//FILE2 PD U!!IT=SYCDA,SPACE=(CYL,(3)) - 001G0OO0 

//FILE3 DD UniT=CYCPA,5PACE=(CYL,(3)) 00170000 

//SYSUPUHP DD SYSOUT=A , 001 800 0" 
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The Catalogued Procedure HALSL 



//::alsl proc nonno^n 

//LKED EXEC PCf , = !!AI.L!'!:'. / nr:P!Or!=100r.,PA.nr'=(LIPT / f:A r ') oin^nion 

//stepm" on P!SP=j;i;R / pr!'=!!Ai.r;:>nn.r" i, :!T r ip, o^p'tooo 

//cvrppi"! rr £Yr;ot. i T=A / po^=nLr.sizn=»i373 * pnn^non 

//CY5LI" DP DSM«!!AI.C3G0.nu::UR,D!SP=5l!P» Oon'ionon 

//SYSLl'! PD PP'!Af'E=nYS!!! OOOOOfinn 

//CYSLI'OD PD DSi!=ar;MALM0D(00),PI5P=(,PAPS),UHIT=5YnnA, 0OO7Pnnn 

// CPACE=(CYL, (1,1,1)) OOOSonon 

//CYSUT1 PD CPACE» ( CYL, (1,1)), IK! ! T= (SYnPA, 5F.P= (SYSL I f!, SYCU'np) ) 00090000 

//STACr.DP.J PI) SPACE=C7RK,(5,10)),UNIT»5YrPA 00100000 

//TEI'PLOAD DP PISP=(!IEW, PASn),PSr!= t 'ir J TI;«"P(TErPr.'Ar'E), ooij"ono-o 

// SPACE=(TRK, {20,20, 1) },UMIT-SYSDA 00120000 
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The Catalogued Procedure HALSLGi 

//::alglg proc ru;:pap.?:= ' oooioooo 

//U'JIV E"EC pn! , =!!ALLI!!K,n~n|On=100!C,PAP M =(L!GT,f«AP) • 00020000 

//STEPLin pd PiEP=c[,T / rir,;'=!:ALn3no.f"n , MTnn 000300*0 

//GYSPRI'JT Pn $YGQUT=A,PCn=rcLK5IZE=1573 Onnf.^000 

//SYGLIP, PD PE;:=!IALG3r>0.P.L'!!I.in,Pir.P=3!!R OO^DOOOO 

//SYSLIi! DP PP:'Ai'!t=GYSI I! 000^1000 

//cyslV.od pp b5::=M:;ALMor-(no),pisp=(,PA?P) / ii!!iT»nYSDA / oonynnon 

// 3PACE=(CYL, (1,1,1)) 000PO0O0 

//SYGUTi PD GPACF. = (CYL, (1,1) ), U'' I T=(SYSPA,SFP=(GYPL IN, SYSLfOD) ) OOOOOQOf) 

//otackopj rn gpacf.=(tp.."., (5,n)),i. ! ::iT=GYrPA ooiooooo 

//TEMPLOAD PP PIGP=C:r.U, P'.GG),PrN'=^." i Tn? , P(THf'P'!A' , E) / ooii*nno 

// SPACE=(TP.K, (20,20, 1) ), UI! !T=SYr.PA 00120000 

//GO EXEC Pnp=*.L!'.EP.SYGLf'OD,P.Er;iOM=10nK, 0ril',0Of)0 

// CQr'D=U,LT,L!'.F.n) OOl-'f^OOO 

// PAP..''.= '^RI ; '!PAPM I 00150000 

//C!!A?if!EL6 DD SYnO!,'T=A OOITOOOO 

//MALPUi'P HP SYGOUT=A 00170000 

//!iALr»Yi:r. dd Du;:;iY oomoooo 

//CIIA*II!F.L5 PD DDIIAHE-SYSI fl OOlOOnno 

//SYSUDW'P PD SYSOUT=A 00200000 
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The 



Catalogued Procedure HALSCLG 



//HALSCLG 
//HAL 

// 

//STEPLIB 

//PROGRAH 
// 



PROC CPTI0tJ=,R0NPAEH= 

EXEC PGK=HOMITOP,REGIOM=300K,TIHE=1. 

PAKM^'SCPTION* 
DD DISP=SHR,DSN=HALS360. MONITOR 
DD DISP=SKK,BS«=HALS360.PHASE1 
DD DISP=SHP,PSN=HALS360.PHASE2 



7/SYSPBINT DD SYSO«^ 

//LISTIUG2 DD SYSOnT = A f DCB-(B*.CPKFbA.^ ', rY r . f1 . ln . 



//LISTIU 
//0UTP0T3 

// 

// 

//00TPUT5 

// 

//ERROR 
//FILE1 
//FILE2 
//FILE3 



DD 



DD DI5P=SHR,DSN=HALS360.E?PORLIB 
DD UKIT=SYSDA,SPACE=(CYL, (3)) 
DD UNIT=SYSDA,SPACE=<CYL, (3)) 
DD UNIT=SYSDA,SPACE={CYL, (3)) 

%IS i0H * ? D xe S c YS p g:=k a iiink,heg.ion=iook,par«=(list, H ap,, 

/, COND=(0,LT,HAL) 

//STEPLIB DD DISP=SHF,DSS=HALS360.«O»ITOB 
//"sPPIHT DD SYSGtIT=A,DCB=BLKSI7,E=1573 
//^SLIB DD DS K = HALS360.EOSLIB,DISP=SHR 
//SV>J DD DISP = {OLD, DELETE), DSH-S6HAL0BJ 

S D D?K-JJHAL«OD(GO) ,DISP=(,PASS, ,0NIT=SYSDA, 

'//sTACKOB, S SPACER* (| 10), ^ £« | 
//UPLOAD DD -K»- (iol^nLn^SYS.^ 

//rn EX*C PGM=*.LKED.SYSLHOD,SEGrOK=100K, 

<f° COND={(0,LT,HAL),(U,LT.LKED)), 

fj PaBF^'f-RUNPARM' 

//CHANNELS DD SYSO*JT = A 

^HaLSyTb Z SKKUlSWB.DISP- (OLD, DELETE) 
//CHANNEL5 DD DDKAKS=SYSIK 
//SYSODUMP DD SYSOUT=A 



//SYSLIN 

// 

//SYSLMOD 

// 

//SYSUT1 



00010000 

00010100 

00010200 

00010300 

00010100 

00010500 

00010600 

00010700 

00010800 

00010900 

00011000 

00011100 

00011200 

00011300 

00011400 

00011500 

00011600 

00011700 

00020000 

00020100 

00020200 

00020300 

00020UOO 

00020500 

00020600 

00020700 

00020800 

00020900 

00021000 

00021100 

00021200 

00030000 

00030100 

00030200 

00030300 

00030500 
00030600 
00030700 
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APPENDIX D. 



Compile Time Error Messages 

A complete list of compile time error messages is 
present! here. The first table gives the mnemonic naming 
scheme used to identify the class-subclass structure of the 
Phase I error messages. The complete list of Phase I errors 
are presented next. Phase II errors are listed last. These 
errors do not have a mnemonic naming scheme and are simply 
lis^l with their severities. The occurrences of double 
question marks (??) in the text of the messages listed here 
indicate positions at which text specific to each actual error 
will be inserted (e.g. a variable name may be inserted to wake 
a clear identification of the error source) . 



LHl 



,/i-kiiir- ^iiinnin^r happa^UIICCTTC AO-IOQ • /(517\ R(!1_1fl/n 



! 



Error Classifications 



Note: "b" denotes a blank. 



CLASS &: ASSIGNMENT STATEMENTS 

A APPAY ASSIGNMENT 

V COMPLEX VARIABLE ASSIGNMENT 

b MISCELLANEOUS ASSIGNMENT 



CLASS Br COMPILER TERMINATION 



:•. ; : - ., ... T !. _t.i'^ ->. .'.- .. :- :-. 

tit NA* 1 !" SCOPE VESTING 

S STACK SIZE LIMITATIONS 

T TABLE SIZE LIMITATIONS 

X COMPILE?. ERRORS 

b MISCELLANEOUS 



CLASS C: COMPARISONS 

b GENERAL COMPARISONS 

CLASS D: DECLARATION ERRORS 

A ATTRIBUTE LIST 

C STORAGE CLASS ATTRIBUTE 

D DIMENSION 

F FUNCTION DECLARATION 

I INITIALIZATION 

L LOCKING ATTRIBUTE 

Q STRUCTURE TEMPLATE TREE ORGANIZATION 

S FACTOP.EP/TTNFACTCRED SPECIFICATION 

T TYPE SPECIFICATION 

U UNDECLARED DATA 

b MISCELLANEOUS 
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CLASS S: EXPRESSIONS 

A ARRAYNESS 

B SIT STRING EXPRESSIONS 

C CROSS PRODUCT 

D DOT PRODUCT 

L LIST EXPRESSIONS 

M MATRIX EXPRESSIONS 

OUTER PRODUCT 

V VECTOR EXPRESSIONS 

h MISCELLANEOUS EXPRESSIONS 



CLASS ?: FORMAL PARAMETERS S ARGUMENTS 

D DIMENSION AGREEMENT 

N NUMBER OE ARGUMENTS 

S SUBBIT ARGUMENTS 

T TYPE AGREEMENT 



CLASS G: STATEMENT GROUPINGS (DO GROUPS) 

B BIT TYPE CONTROL EXPRESSION 

C CONTROL EXPRESSION 

E EXIT/REPEAT STATEMENTS 

L END LABEL 

V CONTROL VARIABLE 



CLASS I: IDENTIFIERS 

L LENGTH 

R REPLACED IDENTIFIERS • 

S QUALIFIED STRUCTURE NAMES 

CLASS L: LITERALS 

B BIT STRING 

C CONVERSION TO INTERNAL FORMS 
F FORMAT OF ARITHMETIC LITERALS 
S CHARACTER STRING 



CLASS M: MULTILINE FORMAT 



C 


OVERPUNCH CONTEXT 


•p 


E-L-TNE 





OVERPUNCH USE 


s 


S-LINE 


b 


COMMENTS 
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CLASS P: PROGRAM CONTROL 6 INTERNAL CONSISTANCE 

C COMPOOL BLOCKS 

D DATA DEFINITION 

E EXTERNAL TEMPLATES 

p FUNCTION RETURN EXPRESSIONS 

L LABELS 

M MULTIPLE DEFINITIONS 

P BLOCK DEFINITION 

S PEOCEDUEE/FUNCTION TEMPLATES 

t> TASK DEFINITIONS 

U CALLS FROM UPDATE BLOCKS 

b MISCELLANEOUS 



CLASS Q: SHAPING FUNCTIONS 

A AF.RAYNESS 

D DIMENSION INFORMATION 

S SUBSCRIPTS 

X ARGUMENT TYPE 



CLASS ?.: REAL TIME STATEMENTS . 

E ON/SEND ERROR STATEMENTS 
T TIMING EXPRESSIONS 
U UPDATE BLOCKS 



CLASS S: SUBSCRIPT USAGE 

C SUBSCRIPT COUNT 

p PUNCTUATION. 

Q PRECISION QUALIFIER 

R RANGE OF SUBSCRIPT VALUES 

S STRUCTURE SUBSCRIPTING 

T SUBSCRIPT TYPE 

V VALIDITY OF USAGE 



CLASS T: I/O STATEMENTS 



wc 



C CONTROL 

D DEVICE NUMB 

b MISCELLANEOUS 



CLASS U: UP! ATE BLOCKS 

I IDENTIFIER USAGE 
p PFOGTA'** FLOCKS 
T I/O 



„ C S ,00^0 • TO COHCO* « • — , — S^ 0,33 • »„ «-1- 



CLASS V: COKPILE-TIHE EVALUATIONS 

A ARITHMETIC OPERATIONS 
C CATENATION OPERATIONS 
D UNDEFINED VARIABLES 
E UNCONFUTABLE EXPRESSIONS 

F FUNCTION EVALUATION 



CLASS X: IMPLEMENTATION DEPENDENT FEATURES 

D DEVICE DIRECTIVE 

I . INCLUDE DIRECTIVE 

I! UNKNOWN OR INVALID DIRECTIVE 



D-5 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION A 

CLASSIFICATION "A" EPRORS ARE RELATED TO ASSIGNMENT STATEMENTS 

AA1 -SEVERITY 1 

ARRAYNESS OF LEFT HAND SIDE OF ASSIGNMENT DOSS NOT MATCH THAT OF RIGHT HAND SIDE 

AA2 ""SEVERITY 1 

ARRAYNESS OF ?? IS INCONSISTENT WITH THAT OF OTHER LEFT HAND SIDE VARIABLES 

AA3 -SEVERITY 1 

ARRAYNESS OF ?? DISAGREES HITH ARRAYNESS OF ITS SUBSCRIPTING 

AVI -SEVERITY 1 

TYPE OF RIGHT HAND SIDE EXPRESSION IS ILLEGAL FOR ASSIGNMENT INTO ?? 

AV2 -SEVERITY *1 

MATRIX DIMENSIONS DISAGREE ACROSS ASSIGNMENT 

AV3 -SEVERITY 1 

VECTOR LENGTHS DISAGREE ACROSS ASSIGNMENT 

AV4 -SEVERITY 1 

TREE ORGANIZATIONS DO NOT BATCH ACROSS ASSIGNMENT 

A1 -SEVERITY 1 

ILLEGAL ASSIGNMENT TO CONSTANT OP PARAMETER ?? 
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PT)ROR MESSAGES FOR MAJOR CLASSIFICATION B 

ERROR H JJJJ«| I j;; i S* „ B „ E o E0BS RESULT FROM ABORTIVE COMPILER FAILURES 

nt»1 -SFVFRITY 2 

INTERMEDIATE CODE STORAGE OVERFLOW: ERROR SCAN CONTINUING 

BN1 —SEVERITY 3 

MAX NAME SCOPS NESTING DEPTH EXCEEDED 

MAXIMUM DEPTH OF DO.. .END GROUP NESTING EXCEEDED 

BS2 -SEVERITY 2 

INDIRECT PARSE STACK SIZE EXCEEDED 

BS3 -SEVERITY 3 

PARSE STACK OVERFLOW 

BS4 -SEVERITY 2 

CURRENT ASRAYNESS STACK SIZE EXCEEDED 

BS5 -SEVERITY 1 

MAXIMUM FUNCTION NESTING DEPTH EXCEEDED 

BT1 -SEVERITY 3 

SYMBOL TABLE OVERFLOW 

BT3 -SEVERITY 3 

LITERAL TABLE LATA OVERFLOW 

BTH -SEVERITY 3 

LITERAL TABLE STRING OVERFLOW 

BT5 -SEVERITY 3 

MACRO TABLE OVERFLOW 

BT7 -SEVERITY 2 ,.„„„« 

INITIAL LIST STORAGE CAPACITY EXCEEDED 

BX1 -SEVERITY 2 

SYT_CLASS = FOR ?? 

BX2 -SEVERITY 2 

FUNC_TOKEN = 

BXU -SEVERITY 3 

TOO MANY BUILT-IN FUNCTIONS 

BX5 -SEVERITY 2 

EXT_ARRAY OVERFLOW 

Bl -SEVERITY 3 

INSUFFICIENT CCRE AVAILABLE 
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ERROR MESSAGES FOE MAJOR CLASSIFICATION C 

CLASSIFICATION »C» ERRORS DEAL KITH COMPARISONS 

CI -SEVERITY 1 

?? COMPARISONS MAY ONLY BE = OP -.= 

C2 -SEVERITY 1 

ARRAYED COMPARISONS APE RESTRICTED TO « OR -»= 

C3 -SEVERITY 1 

TREE ORGANIZATIONS OF STRUCTURES COMPARED DO NOT MATCH 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION D 

CLASSIFICATION »D" ERRORS ARE FIXATED TO DATA DECLARATIONS 

DAO -SEVERITY 1 

CONFLICTING ATTRIBUTE SPECIFIED KITH THE LATCHED ATTRIBUTE 

DA1 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR BIT DATA TYPE 

DA10 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR STRUCTURE DATA TYPE 

•3 

DA11 -SEVERITY 1 

ILLEGAL ATTRI3UTS SPECIFIED IN PROGRAK/TASK DECLARATION 

DA2 -SEVERITY.! 

ILLEGAL ATTRIBUTE SPECIFIED FOR CHARACTER DATA TYPE 

DA20 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOP MINOR STRUCTURE ?? 

DA21 -SEVERITY 1 

AN ARRAY SPECIFICATION IS NOT ALLOWED FOR THE MINOR STRUCTURE ?? 

DA22 -SEVERITY 1 

NO ATTRIBUTES KAY BE SPECIFIED ON A NESTED STRUCTRUE TEMPLATE REFERENCE 

DA23 -SEVERITY 1 

ILLEGAL ATTRIBUTE FOR THE STRUCTURE TERMINAL ?? 

DA3 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR MATRIX DATA TYPE 

DAli -SEVERITY' 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR VECTOR DATA TYPE 

DA5 -SEVERITY 1 

ILLEGAL ATTRIBUTE FOR SCALAR DATA TYPE 

DA6 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR INTEGER DATA TYPE 

DA9 -SEVERITY 1 

ILLEGAL ATTRIBUTE SPECIFIED FOR EVENT DATA TYPE 

DC1 -SEVERITY 1 

ILLEGAL STATIC/AUTO SPECIFICATION FOR ?? 

DC2 -SEVERITY 1 

ILLEGAL STATIC OR AUTO SPEC AT COHPOOL OR PROGRAM LEVEL FOR ?? 

DC! -SEVERITY 1 

ILLEGAL STATIC OR AUTO SPEC FOR THE PAFAMF.TER ?? 

nr*U •» t \FVFRTTY 1 

FACTORED AND NCN-FACTORED TYPE SPECIFICATION FOR ?? DISAGREE 
THE NCN-FACTORED TYPE SPECIFICATION -KILL BE USED 

DD1 -SEVERITY 1 

ILLEGAL ARRAY DIMENSION SPECIFICATION 
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DD10 -SEVERITY 1 

?? BUST BE A PARAMETER FOR USE OF UNKNOWN AEHAY SIZE NOTATION 

DD11 -SEVEPITY 1 

ILLEGAL STRUCTURE DIMENSION SPECIFICATION 

DD3 -SEVERITY 2 

TOO MANY DIMENSIONS IN ARRAY 

DD« -SEVERITY 1 

INVALID MATRIX DIMENSION SPECIFICATION; A DIMENSION OF 3 IS ASSUMED 

DD5 -SEVERITY 1 

INVALID VECT02 LENGTH SPECIFICATION; A 3-VECTOR IS ASSUMED 

DD6 -SEVEPITY 1 

ONLY SINGLE DIMENSION ARRAYS MAY USE THE * TO DENOTE UNKNOWN LENGTH 

DD7 -SEVERITY 1 

A * MAY NOT BE USED TO SPECIFY VECTOR LENGTH; A 3-VECTOR IS ASSUMED 

DD8 -SEVERITY 1 ' " 

?? MUST BS A PARAMETER FOB OSE OF UNKNOWN STRUCTURE COPY NOTATION 

DD9 -SEVERITY 1 

A * MAY NOT BE USED TO SPECIFY A MATRIX DIMENSION; A DIMENSION OF 3 IS ASSUMED 

DF1 -SEVERITY 1 

THE FUNCTION ?? MAY NOT BE DECLARED IN A COMPOOL 

DF2 -SEVERITY 1 

ILLEGAL ATTRIBUTE FOR THE FUNCTION ?7 

DF3 -SEVERITY 1 

THE FUNCTION ?? MAY NOT HAVE AN INITIAL/CONSTANT SPECIFICATION 

DI1 -SEVERITY 1 

REPEAT FACTOR IN INITIALIZATION HAS NO LEGAL VALUE COMPUTABLE AT 
COMPILE TIMS 

DUO -SEVERITY 1 

TOO MANY ELEMENTS SUPPLIED IN INITIAL LIST FOR ?? 

DI2 -SEVERITY 1 

IMP-LIED NUMBER OP ELEMENTS IN INITIAL LIST EXCEEDS COMPILER LIMIT 

DI3 ' -SEVERITY 1 

EXPRESSION IN INITIAL LIST IS NOT COMPUTABLE AT COMPILE TIKE 

DI4 -SSVERITY 1 

INITIALIZATION OF ?? HAS ILLEGAL TERMINATING * : 

NUMBER OF INITIAL VALUES MATCHES TOTAL NUMBER OF ELEMENTS 

DI5 -SEVERITY 1 

TOO FEW ELEMENTS SUPPLIED IN INITIAL LIST FOR ?? 

DI6 -SEVERITY 1 

ILLEGALLY-TYPED INITIAL VALUE — INITIALIZATION OF ?? EXPECTS 
A VALUE OF CHARACTER TYPE 
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DD1 ° "?; T 55SM a parameter fob use of unknown array size notation 

DD11 ^SaTsTRUCTUEE DIMENSION SPECIFICATION 

ft _» — ct? VERITY 2 

TOO MANY DIMENSIONS IN ARRAY 

° DU ' "?SilSM«BC WMMStOIl SPECIFICATION; A DIMENSION OF 3 IS ASSUMED 

DD5 "imIS Y «CT0i LENGTH SPECIFICATION; I 3-VECTOR IS ASSUMED 

DD6 "SS B SINGL'E DIMENSION ARRAYS MAY USE THE * TO DENOTE UNKNOWN LENGTH 

DD7 "f ?ljr.it BE USED TO SPECIFY VECTOR LENGTH; A 3-VECTOR IS ASSUMED 

DD8 T ? V «UST Y BE A PARAMETEB FOR USE OF UNKNOWN STRUCTURE COPY NOTATION 

DM T : S !S\Jt BE USED TO SPECIFY A MATRIX DIMENSION; A DIMENSION OF 3 IS ASSUMED 

DF1 "KFSEtloH 77 «AY NOT BE DECLARED IN A COMPOOL 

° F2 "SIS* ATTRIBUTE FOR THE FUNCTION ?? 

0F3 1S??S«IO» 77 MY NOT HAVE AN INITIAL/CONSTANT SPECIFICATION 

DI1 TepIat'fACTOR IN INITIALIZATION HAS NO LEGAL VALUE COMPUTABLE AT 
COMPILE TIME 

DI10 "^-Sy^LEMENTS SUPPLIED IN INITIAL LIST FOR 72 

DI2 ISeTnUHBER OF ELEMENTS IN INITIAL LIST EXCEEDS COMPILER LI.lt 

013 " "JSSSIql IN INITIAL LIST IS NOT COMPUTABLE AT COMPILE TIME 

DI * ill = vjstssss- ^?sgs^™^»- 

DI5 "^o1ew Y ELEMENTS SUPPLIED IN INITIAL LIST FOR ?? 

DI6 "SSSIy-TYPED. INITIAL VALUE-INITIALIZATION OF 77 EXPECTS 
A VALUE OF CHAEACTER TYPE 



D-1I 

NTERMETRICS INCORPORATED • 701 CONCORD AVENUE -CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



DI7 -SEVERITY 1 

ILLEGALLY-TYPED INITIAL VALUE—INITIALIZATION OF ?? EXPECTS 
A VALUE OF BIT TYPE 

DI8 -SEVERITY 1 

ILLEGALLY-TYPED INITIAL VALUE— INITIALIZATION OF ?? EXPECTS A 
VALUE OF INTEGER OR SCALAR TYPE 

DI9 -SEVERITY 1 

THE DECLARATION OF ?? 'HAS BOTH FACTORED AND UNFACTOSED INITIAL/CONSTANT 
ATTRIBUTES; THE UNFACTORED ATTRIBUTES WILL BE USED 

J; 

DL1 -SEVERITY 1 

ILLEGAL TO SPECIFY LOCKING ATTRIBUTE AT CURRENT NEST LEVEL 

DL2 -SEVERITY *1 

THE LOCKED ATTRIBUTE HAY NOT BE USED IN CONJUNCTION WITH THE CONSTANT ATTRIBUTE 

DQ1 -SEVERITY 1 

FIRST NODE DECLARED IN TEMPLATE MUST B.E AT LEVEL 1 

DQ2 -SEVERITY 1 

ILLEGAL SEQUENCE OF LEVEL NUMBERS IN TEMPLATE 

D03 -SEVERITY 1 

STRUCTURE FUNCTION BEARS SAME NAME AS TEMPLATE SPECIFYING ITS TREE ORGANIZATION 

DQU -SEVERITY 1 

STRUCTURE ?? CANNOT BE MADE UNQUALIFIED - SPECIFIED OR INDIRECTLY REFERENCED 
STRUCTURE TEMPLATE IS ALREADY USED BY AN UNQUALIFIED STRUCTURE 

DQ5 -SEVERITY 1 

STRUCTURE ?? CANNOT BE MADE UNQUALIFIED - SPECIFIED OR INDIRECTLY REFERENCED 
STRUCTURE TEMPLATE IS NOT DECLARED IN SAME NAME SCOPE . 

DS1 -SEVERITY 1 

INVALID BIT-LENGTH SPECIFICATION 

DS10 -SEVERITY 1 

FACTORED AND NON-FACTORED STRUCTURE TEMPLATE REFERENCES DISAGREE; 
NON-FACTORED REFERENCE HILL BE USED 

DS11 -SEVERITY 1 

INPBT/ASSIGN PARAMETERS OF CHARACTER TYPE CAN ONLY BE GIVEN A * LENGTH 

SPECIFICATION- 

DS2 -SEVERITY 1 

INVALID CHAR-LENGTH SPECIFICATION 

DS3 -SEVERITY 1 

A * IS AS ILLEGAL CHARACTER LENGTH SPECIFICATION; A LENGTH OF 8 IS ASSUMED 

DSt -SEVERITY 1 

A * IS AN ILLEGAL BIT LENGTH SPECIFICATION; A LENGTH OF 1 IS ASSUMED 

DS5 -SEVERITY 1 

FACTORED AND NON-FACTORED BIT SIZE SPECIFICATION FOR ?? DISAGREE 
THE NCN-FACTOSED SPECIFICATION WILL BE USED 

DS6 -SEVERITY 1 

FACTORED AND SCK-FACT03ED CHARACTER LENGTH SPECIFICATION FOR ?? DISAGREE 
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ERROR MESSAGES FOE MAJOR CLASSIFICATION E 

CLASSIFICATION "E» ERRORS DEAL HITH EXPRESSIONS 

t*h1 — *SE V 1 ** KITY 1 

ARRAYNESS OF ?? IS INCONSISTENT WITH CURRENT ARRAYNESS OF EXPRESSION 

? n« — ^ F V^^TT Y 

** RESULT OF BIT CATENATION SILL BE LEFT TRUNCATED TO MAXIMUM BIT LENGTH 

EB2 "LABEL 1 ?? USED IN BIT OR EVENT EXPRESSION WAS NOT A PROGRAM OR TASK EVENT 

-J. 

EC1 -SEVERITY 1 

CROSS PFODUCT MUST BE BETWEEN THREE DIMENSIONAL VECTORS . 

EC2 -SEVERITY 1 

CROSS PRODUCT * USED WITHOUT A VECTOR AFTER IT 

EC3 -SEVERITY 1 „„ Tm 

CROSS PRODUCT * USED WITHOUT A VECTOR BEFORE IT 

ED1 -SEVERITY 1 

DOT PRODUCT . USED WITHOUT A VECTOR AFTER IT 

ED2 -SEVERITY 1 

DOT PRODUCT . USED WITHOUT A VECTOR BEFORE IT 

EL1 "oNLY H ARITHM2TIC CONVERSION FUNCTIONS MAY POSSESS ARGUMENTS WITH REPEAT FACTORS 

sn — s'VF^ITY 1 

REPETITION FACTOR 0? EXPRESSION MUST BE AN UNARRAYED INTEGER OR SCALAR 
EXPRESSION COMPUTABLE AT COMPILE TIME 

EM1 -SEVERITY 1 „ „_„ 

DIMENSIONS OF MATRIX OPERANDS IN EXPRESSION DISAGREE 

MATRIX ARITHMETIC TYPE CANNOT BE CONVEBTED TO A CHARACTER STRING 

EM3 -SEVERITY 1 

HAT5IX-MATRIX MULTIPLICATION DIMENSION DISAGREEMENT 

EMU -SEVERITY 1 

INVERSE OF NON-SQUARE MATRIX ATTEMPTED 

E01 -SEVERITY 1 

ILLEGAL PRODUCT: CUTER PRODUCT TIMES A VECTOR 

E02 -SEVERITY 1 

A PRODUCT INVOLVING BOTH CFOSS AND OUTER PRODUCTS IS INDICATED. 
USE MORE PARENTHESES. 

EO-3 -SEVERITY 1 

A "PRODUCT INVOLVING BOTH DOT AND OUTEB PRODUCTS IS INDICATED. 
USE MORE PARENTHESIS. 

EV1 -SEVERITY 1 

LENGTHS OF VECTOR OPERANDS IN EXPRESSION DISAGREE 
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EV2 -SEVERITY 1 

MATRIX-VECTOR MULTIPLICATION DIKENSION DISAGREEMENT 

EV3 -SEVERITY 1 

VECTOR-MATRIX MULTIPLICATION DIMENSION DISAGREEMENT 

EVU -SEVERITY 1 

VECTOR MAY NOT HAVE AS EXPONENT 

EV5 —SEVERITY 1 

VECTOR ARITHMETIC TYPE CANNOT BE CONVERTED TO A CHARACTER STRING 

E1 -SEVERITY 1 

DIVISORS HAY ONLY BE OF INTEGER OR SCALAR TYPE 

E2 -SEVERITY 1 

MATRIX MUST HAVE AN EXPONENT 07 INTEGER TYPE KNOWN AT COMPILE TIME 

E3 -SEVERITY 1 

EXPONENT MUST 3E A SINGLE VALUED QUANTITY 

E4 -SEVERITY 1 

DOT OR CROSS PRODUCT SYMBOL (. OF *) USED IN A PRODUCT NCT INVOLVING VECTORS 

56 -SEVERITY 1 

INCOMPATIBLE ARITHMETIC OPERAND TYPES IN EXPRESSION 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION F 

CLASSIFICATION "F» EBROPS DEAL WITH FORMAL PARAMETERS ANT) ARGUMENTS 

W D1 -SEVERITY 1 

MATRIX DIMENSIONS OF ARGUMENT AND CORRESPONDING FORMAL PARAMETER DO NOT AGREE 

FD2 -SEVERITY 1 

VECTOR LENGTHS OF ARGUMENT AND CORRESPONDING FORMAL PARAMETER DO NOT AGREE 

FD3 -SEVERITY 1 

* " TREE ORGANIZATIONS OF STRUCTURE ARGUMENT AND CORRESPONDING FORMAL PARAMETER ARE 

NOT IDENTICAL * 

FD4 -SEVERITY 1 

aSBAYNESS OF FUNCTION ARGUMENT DOES NOT MATCH CURRENT ARRAYNSSS OF EXPRESSION 

CONTAINING THE INVOCATION 

FD5 -SEVERITY 1 

ARRAYNESS OF ARGUMENT AND CORRESPONDING FORMAL PARAMETER ARE SOT IDENTICAL 

FD6 -SEVERITY 1 

ARGUMENT OF ?? FUNCTION IS NOT A SQUARE MATRIX 

FN1 -SEVERITY 1 

FUNCTION ?? WAS INVOKED WITH TOO FEW ARGUMENTS 

FN2 -SEVERITY 1 

FUNCTION ?? HAS INVOKED KITH TOO MANY ARGUMENTS 

FN3. -SEVERITY 2 

?? USED SORE THAN ONCE AS A PARAMETER 

FN4 -SEVERITY 1 

?? FUNCTION HAS INCORRECT NUMBER OF ARGUMENTS 

FS1 -S'V^RITY 1 

AN ASSIGN ARGUMENT OF A PROCEDURE CALL KAY NOT BE A SUBBIT PSEODO 
VARIABLE 

FT 1 —SEVERITY 1 

TYPE OF FUNCTION ARGUMENT IS INCOMPATIBLE WITH TYPE OF CORRESPONDING 

FORMAL PARAMETER 

FT2 -SEVERITY 1 

?? FUNCTION HAS AN ARGUMENT OF INCORRECT TYPE 

FT3 -SEVERITY 1 

ILLEGAL TYPE FOR THE FUNCTION ?? 

FT4 -SEVERITY 1 

THE SIZE SPECIFICATION FOR THE RETURN TYPE OF FUNCTION ?? DISAGREES WITH THE 

PREVIOUSLY DECLARED SIZE 

FT5 -SEVERITY 1 

FUNCTION ?? KAY NOT POSSESS MULTIPLE STRUCTURE COPIES 

FT6 -SEVERITY 1 

THE STRUCTURE TEKFLATE INDICATED IN THE TYPE SPECIFICATION OF FUNCTION ?? 

DISAGREES WITH THE TEMPLATE USED IN A PREVIOUS DECLARATION 

FT7 -SEVERITY 1 

CONFLICTING SINGLE/DOUBLE SPECIFICATION FOR THE FUNCTION ?? 
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EEEOB MESSAGES FOR MAJOB CLASSIFICATION G ..«.,„.,„»„.■.,., 

CLASSIFICATION »G" ERRORS DEAL WITH STATEMENT GROUPINGS (DO STATEMENTS) 

GB1 —SEVERITY 1 

BIT EXPRESSION IN ?? CLAUSE MUST BE BOOLEAN 

CONTROL EXPRESSION IN A DO CASE BUST RE OF UNARRAYED INTEGER OR SCALAR TYPE 

GC2 -SEVERITY 1 „„.„„„ 

BIT EXPRESSION IN WHILE OR UNTIL CLAUSE MAY NOT BE ARRAYED 

CONTROL EXPRESSIONS IN A DC FOR MOST BE OF UNARRAYED INTEGER OR SCALAR TYPE 

GE1 -SEVERITY 1 

EXIT STATEMENT IS NOT IN AN ENCLOSING DO... END GROUP 

GE2 -SEVERITY 1 

REPEAT STATEMENT IS NOT IN AH ENCLOSING^ DO FOR... END 02 
DO HHILE/UNTIL...END GROUP 

GE3 —SEVERITY 1 

EXIT CAUSES ILLEGAL BRANCHING OUT OF CODE BLOCK DEFINITION 

GEU -SEVERITY 1 

REPEAT CAUSES ILLEGAL BRANCHING OUT OF CODE BLOCK DEFINITION 

GL1 —SEVERITY 1 

LABEL AFTER END STATEMENT DOES NOT MATCH DO STATEMENT LABEL 

GL2 — S'V^RITY 1 

LABEL IS THE DESTINATION OF A GO TO FROH OUTSIDE THE ENCLOSING DO... END GROUP 

GL3 -SEVERITY 1 

GO TO STATEMENT CAUSES A BRANCH INTO A DO... END GROUP 

f*Vl —SEVERITY 1 

CONTROL VARIABLE IN A DO FOR MUST BE OF UNASRAYSD INTEGER OR SCALAR TYPE 
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ERROR MESSAGES FOP. MAJOR CLASSIFICATION I 

CLASSIFICATION "I" ERRORS ARE RELATED TO IDENTIFIERS 

IL1 -SEVERITY 1 

IDENTIFIER NAME MAY NOT END HTH AN UNDERSCORE CHARACTER 

IL2 -SEVERITY 1 

NAME TOO LONG - TRUNCATED 

IR1 -SEVERITY 1 

ILLEGAL REPLACEMENT FOR LOCAL NAME: ?? 

« ■■> 
IR10 -SEVERITY 3 

MAXIMUM NUMBER OF PARAMETERS FOR SOURCE MACRO DEFINITION - EXCEEDED 

IR3 -SEVERITY 1 

MACRO EXPANSION TOO LONG 

IR5 -SEVERITY 1 

DUPLICATE REPLACE FOR ?? 

IR6 -SEVERITY 1 

MACRO NAME ?? NOT DEFINED 

IR7 -SEVERITY 2 

REPLACE PARAMETER STRING TOO LONG; REPLACE NOT PERFORMED 

IR8 -SEVERITY 2 

INCORRECT NUMBER OF PARAMETERS FOR MACRO CALL; REPLACEMENT NOT PERFORMED 

IR9 -SEVERITY 3 

MACRO EXPANSION STACK OVERFLOW; RECURSIVE DEFINITION LIKELY 

IS1 -SEVERITY 1 

ILLEGAL CONSTRUCTION OF QUALIFIED STRUCTURE NAME 
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EEROH MESSAGES FOR HAJOR CLASSIFICATION L 

CLASSIFICATION "L" ERRORS PFAL WITH LITERALS 

LB1 -SEVERITY 1 

BIT CONSTANTS KAY NCT BE LOKCER THAN 32 BITS 

LB2 -SEVERITY 1 

DECIMAL BIT CONSTANT HOST SPECIFY OR IMPLY A REPETITION FACTOR OF 1 

LB3 -SEVERITY 1 

ILLEGAL DECIKAL STRING IN DECIKAL BIT CONSTANT 

LBU -SEVERITY 1 

ILLEGAL CHARACTER IN DECIMAL BIT CONSTANT 

LBS -SEVERITY 1 

ILLEGAL CHARACTER IN BINARY BIT CONSTANT 

LB6 -SEVERITY 1 

ILLEGAL CHARACTER IN OCTAL BIT CONSTANT 

LB7 —SEVERITY 1 

ILLEGAL CHARACTER IN HEXADSCIHAL BIT CONSTANT 

LB8 -SEVERITY 1 

REPETITION FACTOR OF A BIT LITERAL HOST BE GREATER THAN ZERO 

LC2 -SEVERITY 1 

?? NOT EXPRESSIBLE INTERNALLY 

LF1 -SEVERITY 1 

ILLEGAL NUMERIC LITERAL CONSTRUCTION 

LF2 -SEVERITY 1 

ONLY ONE DECIMAL POINT ALLOWED 

LF3 -SEVERITY 1 

TOO HANY SIGNIFICANT DIGITS - 74 ALLOWED 

LF5 -SEVERITY 1 

EXPONENT INDICATOR BUT NO EXPONENT DIGITS 

LS1 -SEVERITY 

CHARACTER STRING TOO LONG - TRUNCATED TO 255 CHARACTERS 

LS2 -SEVERITY 1 

REPETITION FACTOR OF A CHARACTER LITERAL IS NOT GREATER THAN ZERO 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION M 

CLASSIFICATION «M'« ERRORS DEAL WITH MULTI-LINE FORMATS 

MCI -SEVERITY 1 

ILLEGAL CONTEXT FOR OVERPUMCH 

KC2 -SEVERITY 1 

OVERPONCH ILLEGAL ON FUNCTION NAMES 

KC3 -SEVERITY 1 

OVERPONCH ILLEGAL ON REPLACED NAMS 

XCH -SEVERITY 

0V3RPUNCH NOT VALID ON RESERVED WORD ?? 

HC5 -SEVERITY* 

OVERPUNCH ILLEGAL ON PARAMETER ?? 

KC6 -SEVERITY 

OVERPUNCH ILLEGAL IN DECLARATION OF ?? 

ME1 -SEVERITY 3 

EXPONENT STRING OVERFLOW 

ME2 -SEVERITY 1 

E-LINE CHARACTER MORE THAN ONE LINE ABOVE PRECEDING CHARACTER 

KE3 -SEVERITY 1 

E-LINE OVERLAPS M-LINS 

ME4 -SEVERITY 1 

OVERLAPPING E-LINE CHARACTERS 

K01 -SEVERITY 

OVERPONCH ILLEGAL 

M02 -SEVERITY 1 

INVALID OVEEFUHCH ON ?? 

M03 -SEVERITY 

MULTIPLE OVERPUNCHSS NOT VALID - FIRST ACCEPTED 

K04 -SEVERITY 1 

USER SUPPLIED OVERPONCH CHARACTER NOT VALID - IGNORED 

MS1 -SEVERITY 3 

SUBSCRIPT STRING OVERFLOW 

HS2 -SEVERITY 1 

S-LINE CHARACTER MORE THAN ONE LINE LOWER THAN PRECEDING CHARACTER 

MS3 -SEVERITY 1 

S-, LJHS ..OVERLAPS M-LINE 

MS4 -SEVERITY 1 

OVERLAPPING S-LINE CHARACTERS 

Ml -SEVERITY 

ILLEGAL CARD TYPE - CHANGED TO A COMMENT 

82 -SEVERITY 1 

INVALID SEQUENCE OF CARD TYPES 

M3 -SEVERITY 

COMMENT LONGER THAN 256 CH?PACTE"<5 - paq »»«■ mr 

1-nf.riu.^.ib - HAS BEEN TRUNCATED 

D-19 



ERROR MESSAGES FOR MAJOR CLASSIFICATION P 

CLASSIFICATION "P" ERRORS INDICATE FLOW CONTROL PROBLEMS 

PC1 -SEVERITY 1 

COMPOOL BLOCK CONTAINS STATEMENT (S) >OTKER THAN DECLARATIONS 

PC2 -SEVERITY 1 

COMPCOL TEKPLATE CONTAINS STATEMENT (S) OTHER THAN DECLARATIONS 

PD1 -SEVERITY 1 

ILLEGAL DECLARATION FOR THE PARAMETER ?? 

PE1 -SEVERITY 1 

EXTERNAL TEMPLATES MUST HOT APPEAR WITHIN A BLOCK DEFINITION 

PE2 -SEVERITY 1 

EXTERNAL TEMPLATES MUST MOT BE PLACED AFTER A BLOCK DEFINITION 

PF1 -SEVERITY 1 

RETURN FROM FUNCTION BLOCK SUST BE FOLLOWED BY AN EXPRESSION 

PF2 -SEVERITY 1 

RETURN KAY ONLY BE FOLLOWED BY AN EXPRESSION IN A FUKCTIOtI BLOCK 

PF3 -SEVERITY 1 

EXPRESSION TO BE RETURNED KAY NOT POSSESS ARRAYNESS 

PF4 -SEVERITY 1 

ILLEGAL TYPE CONVERSION OF RETURNED EXPRESSION REQUIRED 

PF5 -SEVERITY 1 

MATRIX DIMENSIONS OF FUNCTION DISAGREE KITH THOSE OF RETURN EXPRESSION 

PF6 -SEVERITY 1 

VECTOR LENGTH CF FUNCTION DISAGREES WITH THAT OF KETUP.H EXPRESSION 

PF7 -SEVERITY 1 

TREE ORGANIZATION OF FUNCTION DOES NOT MATCH THAT OF RETURN EXPRESSION 

PL1 -SEVERITY 1 

THE FUNCTION ?? HAS BEEN DECLARED BUT SOT DEFINED 

PL2 -SEVERITY 2 

?? I'S A DUPLICATE LABEL 

PL3 -SEVERITY 1 

LABEL ON CLOSE DOES NOT MATCH BLOCK DEFINITION LABEL: ?? 

PL4 -SEVERITY 1 

FUNCTION LABEL CONFLICT 

PL5 -SEVERITY 1 

LABEL ?? IS NOT DEFINED WIT3IN THE CURSENT SCOPE 

PL6 -SEVERITY 1 

THE PROCEDUEE/TASK ?? HAS BEEN CALLED/SCHEDULED BUT NOT DEFINED 

PK1 -SEVERITY 2 

DUPLICATE DEFINITION FOR ?? 
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PM3 -SEVERITY 1 

EARLIER DEFINITION OVERRIDDEN FOB ?? 

PKU -SEVERITY 

OUTER DEFINITION OVERRIDDEN £02 ?? 

PPl -SEVERITY 1 

A ?? DEFINITION BUST BE THE CUTEEMOST BLOCK DEFINITION 

PP2 -SEVERITY 1 

BLOCK DEFINITION IS NOT THE FIRST OUTEPHOST BLOCK DEFINITION 

PP3 -SEVERITY 1 •> 

A ?? DEFINITION CANNOT BE AN OUTERMOST BLOCK DEFINITION 

PPIJ -SEVERITY 1 

NO BLOCK DEFINITIONS WERE ENCOUNTERED IN COMPILATION 

PS1 -SEVERITY 1 

EXTERNAL PROCEDURE/FUNCTION TEMPLATE CONTAINS STATEMENT (S) 
OTHER THAN DECLARATIONS 

PS2 -SEVERITY 1 

ONLY PROCEDURES OR FUNCTIONS MAY BE DESIGNATED ?? 

PS3 -SEVERITY 1 

ONLY PROGRAM, PROCEDURE AND FUNCTION BLOCKS MAY POSSESS THE ACCESS ATTRIBUTE 

PT1 -SEVERITY 1 

TASK DEFINITIONS MAY ONLY APPEAR WITHIN AN IMMEDIATELY ENCLOSING 
PR OG RAM DEFINITION 

PU3 -SEVERITY 1 

INVOCATIONS IN AN UPDATE BLOCK OF PROCEDURES OR USER FUNCTIONS DEFINED 
OUTSIDE THE BLOCK ARE ILLEGAL 

P1 -SEVERITY t 

EKD-OF-FILE AT INVALID POINT IN SOURCE TEXT 

P3 -SEVERITY 

BLOCK SUMMARY TABLE OVERFLOB 

P4 -SEVERITY 2 

CONFLICTING USE OF ?? 

P5 -SEVERITY 1 

TOO MANY MACRO EXPANSIONS FOE ?? 

P6 -SEVERITY 

PROGRAM LAYOUT TABLE EXCEEDED 

V 

P8 -SEVERITY 1 y 

THE FOLLOWING SYMBOL IS SYNTACTICALLY ILLEGAL IN THE CONTEXT USED: ?? 
ERROR RECOVERY MAY CAUSE SUBSEQUENT SPURIOUS ERRORS 
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EFROS MESSAGES FOR MAJOR CLASSIFICATION Q 

CLASSIFICATION "Q" ERRORS DEAL WITH SHAPING FUNCTIONS 

n ft 1 •■ *5 EVEK IT Y 1 

ARRAYNESS 0? SINGLE ARGUMENT OF INTEGER/SCALAR CONVERSION FUNCTION DOES NOT 
HATCH THAT OF EXPRESSION CONTAINING FUNCTION 

0A2 -SEVERITY 1 

ARRAYNESS OF RESULT OF "INTEGER/SCALAR CONVERSION FUNCTION IN UNCOMPOTABLE 

rt»o ••SEVERITY 1 

SPECIFIED ASRAYNESS OF INTEGER/SCALAR CONVERSION FUNCTION IS INCONSISTENT WITH 
NUMBER OF DATA ELEMENTS SUPPLIED IN ARGUMENT LIST 

OAtt -SEVERITY 1 

ARRAYNESS OF RESULT OF INTEGER/SCALAR CONVERSION FUNCTION DOES NOT BATCH THAT 

OF EXPRESSION CONTAINING FUNCTION 

nnl •»*J T? VFR" r TY 1 

DIMENSIONS OF VECTOR/MATRIX CONVERSION FUNCTION DO NOT AGREE WITH THE NUMBER 
OF DATA ELEHENTS SUPPLIED IN THE ARGUMENT LIST 

OD2 -SEVERITY 1 „ „ 

BIT OR CHARACTER CONVERSION FUNCTION MAY ONLY HAVE ONE ARGUMENT 

Q " i "COLONS AND SEMICOLONS MAY NOT APPEAR IK SUBSCRIPT OF CONVERSION FUNCTIONS 

" ' BIT"0R CHARACTER CONVERSION FUNCTION MAY ONLY HAVE ONE SUBSCRIPT 

QS11 -SEVERITY 1 

SUBBIT CONVERSION FUNCTION MAY ONLY RAVE ONE SUBSCRIPT 

0S12 -SEVERITY 1 „„,.„, 

COLONS AND SEMICOLONS MAY NOT APPEAR IN THE SUBSCRIPT OF A SUBBIT 
PSEUDO-VARIABLE 

fl^i^ —SEVERITY 1 
' SUBSCRIPT OF A SUBBIT PSEUDO- VARIABLE KAY NOT CONTAIN A PRECISION 

MODIFIER 

QS2 -^SEVERITY 1 

MATRIX CONVERSION FUNCTION DOES NOT HAVE TWO SUBSCRIPTS 

0S3 -SEVERITY 1 

VECTOR CONVERSION FUNCTION DOES NOT HAVE ONE SUBSCRIPT 

OSU -SEVERITY 1 

INTEGER OR SCALAR CONVERSION FUNCTION HAS MORE THAN MAXIMUM PERMITTED 

NUMBER OF SUBSCRIPTS 

SUBSCRIPT OF ARITHMETIC CONVERSION FUNCTION IS NOT A SINGLE INDEX 

n*?fi —^vvFRITY 1 

SUBSCRIPT OF ARITHMETIC CONVERSION FUNCTION MAY NOT CONTAIN # VALUES 

0S7 — S^V^ITY 1 

SUBSCRIPT OF ARITHMETIC CONVERSION FUNCTION MUST BE AN UNARRAYED INTEGER/SCALAR 

EXPRESSION COMPUTABLE AT COMPILE TIME 
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QS8 -SEVERITY 1 



VALUE CF SUBSCRIPT OF ARITHMETIC CONVERSION FUNCTION LIES OUTSIDE LEGAL RANGE 

OS9 — S'VE^ITY 1 

SUBSCRIPT OF BIT OR CHARACTER CONVERSION FUNCTION HAY NOT CONTAIN A PRECISION 

QUALIFIER 

0X1 -SEVERITY 1 

CONVERSION FUNCTIONS MAY NOT HAVE ARGUMENTS OF STRUCTURE TYPE 

MATRIX/VECTOR CONVERSION FUNCTIONS MAY NOT HAVE ARGUMENTS OF BIT TYPE 

0X3 -SEV p; >ITY '1 

MATRIX/VECTOR CONVERSION FUNCTIONS HAY NOT HAVE ARGUMENTS OF CHARACTER TYPE 

OXtt -SEVERITY 1 

MATRIX OR VECTOR ARGUMENT IS ILLEGAL IN BIT OR CHARACTER CONVERSION FUNCTION 

0X5 -SEVERITY 1 

CHARACTER CONVERSION FUNCTION HITH RAtflX DOES NOT HAVE ARGUMENT OF BIT TYPE 

AY A •'JPV^RTTY 1 

BIT 'CONVERSION FUNCTION WITH RADIX DOES NOT HAVE ARGUMENT OF CHARACTER TYPE 

A«n .c^vppTTY 1 

IN AN ASSIGNMENT CONTEXT THE ARGUMENT OF A SUBBIT PSEUDO-V AEI ABLE SAY NOT 
ITSELF BE A SUBBIT PSEUDO-VARIABLE 

0X8 -SEVERITY 1 

ARGUMENT OF ILLEGAL TYPE IN SUBBIT PSEUDO-VARIABLE 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION R 

CLASSIFICATION "R" ERRORS ARE BELATED TO REAL-TIME STATEMENT ERRORS 

R.E1 -SEVERITY 1 

ILLEGAL FORM OP, VALUE OF ON ERROR SUBSCRIPT 

RE2 -SEVERITY 1 

ILLEGAL FORM OR VALUE OF SEND ERROR SUBSCRIPT 

SE3 -SEVERITY 1 

TOO MANY ON ERROR STATEMENTS ACTIVE 

RT1 -SEVERITY 1 

SCHEDULE STATEMENT CONTAINS AN ILLEGAL FORM OF ?? TIMING EXPRESSION 

RT10 -SEVERITY' 1 

AN UNLATCHED EVENT MAY NOT BE SET OR RESET 

RT2 -SEVERITY 1 

WHILE EXPRESSION MAY NOT BE A TIMING EXPRESSION 

RT3 -SEVERITY 1 

SCHEDULE STATEMENT CONTAINS AN ILLEGAL FORM OF ?? EVENT EXPRESSION 

RT4 -SEVERITY 1 

?? STATEMENT CONTAINS ILLEGAL PRIORITY EXPRESSION 

BT5 -SEVERITY 1 

SCHEDULE STATEMENT CONTAINS DUPLICATED AT/IN/ON EXPRESSIONS 

RT6 -SEVERITY 1 

WAIT STATEMENT CONTAINS ILLEGAL FORM OF ?? EXPRESSION 

RT7 -SEVERITY 1 

EVENT MUST BE SIGNALLED ON/OFF OR ITS BINARY EQUIVALENT 

RT8 -SEVERITY 1 

AN ARRAY2D EVENT MAY NOT BE SIGNALLED 

RT9 -SEVERITY 1 

?? MUST BE A PROGRAM OR PROCEDURE IN ORDER TO BE SCHEDULED 

RU1 -SEVERITY 1 

SIGNAL STATEMENTS ARE THE ONLY REAL-TTKK STATEMENTS WHICH HAY APPEAR INSIDE 
AN UPDATE BLOCK 
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SREOE HESSAGES FOB HAJOR CLASSIFICATION S 

CLASSIFICATION »S" EREOES INDICATE INCORRECT SUBSCRIPT OSAGE 

SC1 -SEVERITY 1 

?? HAS TOO MANY STRUCTURE SUBSCRIPTS 

SC2 -SEVERITY 1 

?? HAS TOO MANY ARRAY SUBSCRIPTS 

SC3 -SEVERITY 1 

?? HAS TOO FEW AREAY SUBSCRIPTS 

SCll -SEVERITY 1 

?? HAS TOO MANY COMPONENT SUBSCRIPTS 

SC5 -SEVERITY 1 

?? HAS TOO' FEW COMPONENT SUBSCRIPTS 

SP1 -SEVERITY 1 

SUBSCRIPTING CONTAINS MORE THAN ONE LIST 0F STRUCTURE SUBSCRIPTS 

SP2 -SEVERITY 1 

SUBSCRIPTING CONTAINS MORE THAN ONE LIST OF ARRAY SUBSCRIPTS 

SP3 -SEVERITY 1 

SU3SCRIPT CONTAINS LEADING COLON, OR A COLON PRECEDED BY A SEMICOLON, 
COLON, CR COMMA 

SP1» -SEVERITY 1 

SUBSCRIPT CONTAINS LEADING SEMICOLON, OR A SEMICOLON PRECEDED BY A SEMICOLON, 
COLON, OR COMMA 

SP5 -SEVERITY 1 

SU3SCRIPT CONTAINS A LEADING COMMA, OR A COMMA PRECEDED BY A SEMICOLON, COLON, 
OR COMMA 

SP6 -SEVERITY 1 

SUBSCRIPT IS EMPTY OR CONTAINS A TRAILING COMMA 

SQ1 -SEVERITY 1 

?? IS OF INCOERECT TYPE TO POSSESS A PRECISION QUALIFIER 

SQ2 -SEVERITY 1 

SUBSCRIPTED VARIABLE ?? MAY NOT POSSESS A PRECISION MODIFIER 

SQ3 -SEVERITY 1 

?? IS IN AN ASSIGNMENT CONTEXT AND THEREFORE MAY NOT POSSESS A 
PRECISION QUALIFIER 
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SR1 — SEVERITY 1 

SIZE OF PARTITION IN A SUBSCRIPT OF ?? WAS UNKNOWN 

5P2 -SEVERITY 1 ' „„ 

SIZE OF PARTITION IN SUBSCRIPT OF ?? IS EITHER LESS THAN 2 OH 
PRODUCED AN INDEX VALUE GREATER THAN THE MAXIHUH ALLOWABLE 

*n-i -SEVERITY 1 

THE VALUE OF A SUBSCRIPT OF ?? WAS GREATER THAN THE CORRESPONDING DIMENSION 

3R4 -SEVERITY 1 

THE VALUE OF A SUBSCRIPT OF ?? KAS LESS THAN 1 
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,•(•4 "-SEVERITY 1 

IN SUBSCRIPT OF ?? ONLY TRAILING ASTERISKS MAY BE OHITTED 

ST1 -SEVERITY 1 

A SUBSCRIPT OF ?? WAS NOT OP INTEGER OR SCALAR TYPE 

rnl -^FVFRITY 1 

SUBSCRIPTING OF ?? IS ILLEGAL IN CONTEXT OF (JSE AS AN ASSIGN ARGUMENT 

ewo •» < 5 1? VFPXTY 

USER SUPPLIED CVERPUNCH. NOT CONSISTENT WITH SUBSCRIPTING FOR VARIABLE ?? 

SV3 -SSVERITY 1 

?? MAY NOT- POSSESS SUBSCRIPTS 



D-27 

INTERMETRICS INCORPORATED • 701 CONCORD AVENUE • CAMBRIDGE, MASSACHUSETTS 02138 • (617) 661-1840 



ERROR "^"I^S^^^KS^tS !!!™ INPUT/OUTPUT STATEMENTS 
TC1 "SS5S OF I/O CONTBOL FUNCTION »UST BE OF UNARRAYED INTEGER OR SCALAR TYPE 
TD1 ~??fSmci BOHBSB IS NOT IN RANGE THROUGH ?? 

TD2 "KSIFIdJhSSS IS NOT AN UNARRAYED INTEGER OR SCALAR 

T1 "?A?IABLE Jh READALL IS NOT OF CHARACTER TYPE 

T2 ■ "Salable In read hay not be of event type 

TarTabTe In read/readall kay not be a subbit pseudo-variable 
T fIleItatekent may not bead into a subbit pseudo-variable 
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EPE0B ^sSlS^ ^^^fs'^S^H UPDATE BLOCKS 

011 '?f ha^only be used within AN UPDATE BLOCK 

U12 "fpDATE^BLOCK DEFINITION «AY NOT APPEAR INSIDE AN UPDATE BLOCK 

UP1 "KPSSsiuBE, TASK, Oh"mOGFM M «AY NOT BE INVOKED WITHIN THE 
CURRENT UPDATE BLOCK 

UP2 "nfD^fBLodKS KAY NOT CONTAIN RETURN STATEMENTS 

" P3 - "?HE E FuScTioN 7 ? HAY NOT BE INVOKED WITHIN THE CURRENT UPDATE BLOCK 

° T1 "i/oItItEHENTS ARE ILLEGAL INSIDE UPDATE' BLOCKS 
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ERROR MESSAGES FOR MAJOR CLASSIFICATION V 

CLASSIFICATION "V" ERRORS ARE RELATED TO COMPILE-TIME VARIABLE ERRORS 

VA1 -SEVERITY 1 

COMPILE TIME INTEGER/SCALAR ADDITION FAILED 

VA2 -SEVERITY 1 

COMPILE-TIME INTEGER/SCALAR SUBTRACTION FAILED 

VA3 -SEVERITY 1 

COMPILE TIME INTEGER/SCALAR MOLTIPLICATIOtJ FAILED 

VA4 -SEVERITY 1 

COMPILE-TIME INTEGER/SCALAR DIVISION FAILED 

VA5 -SEVERITY 1 

COMPILE TIME INTEGER/SCALAR EXPONENTIATION FAILED 

VC1 -SEVERITY 

COMPILE-TIME CATENATION PRODUCED TOO LONG A CHARACTER STRING - 
TRUNCATED TO 255 CHARACTERS 

VD1 -SEVERITY 1 

THE VARIABLE ?? IS USED IN A COMPILE-TIME EXPRESSION BUT IS NOT 
PREVIOUSLY DEFINED 

VE1 -SEVERITY 1 

AN EXPRESSION HOT COMPUTABLE AT COMPILE-TIME HAS BEEN USED IH A CONTEXT HHESE 
A VALUE MUST BE KNOWN 

7F1 -SEVERITY 1 

COMPILE-TIME EVALUATION OF ?? FUNCTION FAILED 
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EEROE MESSAGES FOR S*AJOR CLASSIFICATION X 

CLASSIFICATION' "X" ERRORS DEAL WITH IMPLEMENTATION DEPENDENT FEATURES 

XD1 -SEVERITY 

UNINTELLIGIBLE INFORMATION IN DEVICE DIRECTIVE 

XE2 -SEVERITY 

DUPLICATE DEVICE DIRECTIVE FOR CHANNEL ?? 

XD3 -SEVERITY 

DEVICE DIRECTIVE DOES NOT CONTAIN A VALID CHANNEL INDICATION 

XD4 -SEVERITY 

CHANNEL NUMBERS MUST BE IN RANGE TO 9 

XI1 -SEVERITY 

NESTEE INCLUDE DIRECTIVES HOT ALLOWED 

« 

XI2 -SEVERITY 

INCLUDE DIRECTIVE DOSS NOT CONTAIN A NAME 

XI3 -SEVERITY 

?? NOT IN INCLUDE LIBRARY 

XU1 -SEVERITY 

D CARD CONTAINS UNKNOWN DIRECTIVE 
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Phase II ERRORS 



SEVERITY 2 

DATA STORAGE CAPACITY EXCEEDED 

SEVERITY 2 

INDIRECT STACK OVERFLOW 

SEVERITY 2 

CHARACTER LITERAL BUFFER OVERFLOW 

SEVERITY 1 

LITERAL PROCESSING FAILURE 

SEVERITY 2 

CONSTANT TABLE OVERFLOW 

SEVERITY 1 

TOO MANY EXTERNAL NAMES 

SEVERITY 1 

STORAGE DESCRIPTOR STACK OVERFLOW 

SEVERITY 1 

EXCEEDED TEMPORARY SPACE 

SEVERITY 

INDEX STACK USAGE INCONSISTANT 

SEVERITY 2 

STATEMENT LABELS ALL IN USE 

SEVERITY 1 

SIZE CONFLICT ON VECTOR/MATRIX PARAMETER 

SEVERITY 1 

ASSIGN PARAMETER NOT SYMBOL 

SEVERITY 1 

DATA TYPE CONFLICT ON PARAMETER 

SEVERITY 1 

ARRAYNESS CONFLICT ON PARAMETER 

SEVERITY 1 

HRR^.Y SIZE CONFLICT ON PARAMETER 
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SEVERITY 1 

NO? ASSIGN PARAMETER 

SEVERITY 2 

SUBPROGRAM STACK OVERFLOW 

SEVERITY 1 

STATEMENT CONTAINS PHASE I ERROR 

SEVERITY 

UNMATCHED DO CASE ENDING 

SEVERITY 
UNMATCHED CASE LABEL 

SEVERITY 

TINHATCHFD DO WHILE ENDING 

SEVERITY 

UNMATCHED DO FOR ENDING 

SEVERITY 1 

LEVEL MISMATCH ON PBOC/FTINC/IO ARGUMENT 

SEVERITY 1 

LEVEL MISMATCH ON SHAPING FUNCTION 

SEVERITY 1 

UNIMPLSMENTED FEATURE OF HAL/S CALLED FOR 

SEVERITY 1 

REAL TIME COMPILER . OPTION NOT SPECIFIED 
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APPENDIX E. 



Execution-time Errors 

The followinq tables indicate runtime error conditions which 
may occur during execution of a HAL/S-360 program. The tables 
list any standard fixups performed by the runtime system. The 
form of the system action taken is indicated by the followxng 
code: 

U * UNLIMITED 

L LIMITED 

T TERMINATE 



"JL 
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Error 

Number 


■ 1 

Message 


Explanation 


Standard Fixup 


SYSTEM 
Action 


i 

| 1 ' 

i 
i 
1 

1 


EXPONENT OVERFLOW 


the exponent of a scalar 
or of a vector/matrix 
element' has overflowed 


the result is set 
to the maximum 
value representabli 
on the machine 


L 


2 


EXPONENT UNDERFLOW 

• 


the exponent of a scalar 
or of a vector/matrix 
element has underf lowed 


the result is set 
to zero 


U 


3 


1 

SCALAR DIVISION BY ZERO 


a scalar division by 
zero has occurred 


the result is set 
to the maximum 
value representablc 
on the machine 


L 


4 


EXPONENTIATION OF ZERO TO 
POWER <= 


a negative or zero 
power was specified 


the result is set 
to zero 


U '■ 


5 


SQUARE ROOT HAS ARG < 




the result is the 
square root of the 
absolute value of 
the argument 


U 



H 
I 



r 



Error 
Number 



Message 



Explanation 



Standard Fixup 



SYSTEM 
Action 






EXP FUNCTION HAS ARG > 174.673 



the result is set to 

the maximum value 
representable on the 
machine 



LOG FUNCTION HAS ARG < " 



6 



if the argument was 
zero then the result 
is ctct to "cne maxi- 
mum representable 
negative value, else 
it is set to the log 
of the absolute value 
oE the arg. 



SIN' OR COS FUNCTION HAS 



|arg|'{J; 



,f 2.62JE5 ) 



126E15 f 



PI 



the two figures are for 
single and double pre- 
cision arguments 
respectively 



10 



SIN OR COSH FUNCTION HAS 
ARG > 175,366 



ARCS IN OR ARCCOS FUNCTION HAS 
I ARG I > 1 



the result is set 
to 



VT" 



the result is set to 
the maximum value 
representable 



the result is set tr> 
zero' 



M 
I 

.fc. 



Error 

Number 


t 

Message 


Explanation 
t 


I ■ ,! 

SYSTEM 
Standard Fixup Action 


11 


TAB FUNCTION HAS 


the two figures are 3:or 
single and double preci- 
sion respectively 


the result is set 
to one 


L 


; 

12 


TAN FUNCTION TOO CLOSE TO 
SINGULARITY 


the argument is too close 
to an odd multiple of 

IT/2 


the result is set to 
the maximum repre- 
sentable value 


L 


13 


CASE VARIABLE OUT OF RANGE 


the value of the case 
variable is either <1 or 
greater than the number 
of cases and there was 
no ELSE clause 


the do case state- 
ment is ignored 


L 


14 


CLOSE REACHED ON 
FUNCTION 


no return statement was 
encountered prior to 
reaching the close of the 
function 


none: IGNORE not • 
allowed 


T 


15 


SCALAR TOO LARGE FOR INTEGER 
CONVERSION 




the result is set 
to the maximum 
representable value 


L 



Error 
Number 


Message 


Explanation 


Standard Fixup 


SYSTEM 
Action 


16 


INTEGER DIVISION BY ZERO 


DIV OPERATOR HAS ZERO 

'divisor 


The result is set 
to the maximum 
representable 
value 


L 


17 


ILLEGAL CHARACTER SUBSCRIPT 


Character component 
subscripting out-of- 
bounds 


The out-of-bounds 
subscript (s) set 
to first or last 
character 


U 


18 


BAD LENGTH IN LJUST OR RJUST 


The length is less 
than the string length 


Truncation to the 
specified length 
occurs on the left 
(RJUST) or right 
(LJUST) 


U 


19 


' MOD DOMAIN ERROR 


In A mod B 
B=0 and A<0 


Returns A 
(negative) 


L 


20 


CHARACTER TO SCALAR CONVERSION 


The string was not in 
standard internal 
format for integers .or 
scalars. 


The result is 
zero. 
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05 
05 



Error 
Number 


Message 


• ■■ ■■>■■■■>— - l — - — — 

Explanation 
t 


Standard Fixup 


i 

SYSTEM 
Action 


21 


CHARACTER TO SCALAR 
CONVERSION DURING INPUT 


Same as above. 


The variable is 
left unchanged. 


u 


22 


CHARACTER TO INTEGER 
CONVERSION 


The string was not in 
standard internal 
format for integers 


The result is zero. 


u 


23 


i 
CHARACTER TO INTEGER 
CONVERSION DURING INPUT 


Same as above. 


The variable is 
left unchanged 


u • 


24 


NEGATIVE BASE IN 
EXPONENTIATION 


A**B where A<0 


z The result is 
| a| **b 


L 


. 25 


VECTOR/MATRIX DIVISION 
BY ZERO 




The result is 
the original 
vector/matrix 


L 



03 
O 



Error 

Number 



MESSAGE 



26 



ILLEGAL BIT STRING 
DURING INPUT 



27 



ARG OF INVERSE IS SINGULAR 



EXPLANATION 



Character other than 
blank,' zeros or ones 



STANDARD FIXUP 



Variables left 
unchanged 



The result is the 
identity matrix 



SYSTEM 
Action 



28 ARG OF UNIT FUNCTION IS, 
NULL VECTOR 



29 



Every component of the 
vector was zero in 
value. 



The result is a 
vector all of whose 
components is zero. 



ILLEGAL BIT STRING 



Returns 
zero 



30 



UNUSED 



td 
I 
oo 



Error 

Number 


Message 


Explanation 


Standard Fixup 


I 

SYSTEM 
Action 


31 


SYNAD ERROR: XXX 


An input transmission 
error was detected. 
The SYNAD message "xxx" 
describes the error. 


The block is 
accepted as is 
(ERROPT=ACC) 


L 


32 


MISSING DD CARD - CHANNELN 


The user did not specify 
a DD card for the speci- 
fied channel. 


I/O on the channel 
is ignored 


T 


33 


PRINT ON INPUT CHANNEL N 

or 
INPUT ON. PRINT CHANNEL N 


I/O was attempted on 
specified channel in 
print mode as well as 
read/readall mode. 


The channel remains 
in the original 
mode, I/O in the 
new mode is ignored. 


T 


34 


ILLEGAL SKIP COUNT ON CHANNEL n 

! « 


The number of skips 
is negative. 


Skip (0) is assumed 


L \ 


35 


MARGIN VIOLATION ON CHANNEL n 

' ... 


A TAB or COLUMN I/O 
control function was 
specified which forced 
the device mechanism 
off the left or right 
marain. 


The horizontal posi- 
tion is reset to eitr er 
column one (left 
margin error) or just ** 
off the right-hand 
margin. On an I/O 
■ transfer this latter 
causes an immediate 

skip to the next linq. 



I 

U5 



Error 

Number 


Message 


Explanation 


Standard Fixup 


" ■ 
SYSTEM " 

Action 


36 


ILLEGAL PAGE COUNT ON CHANNEL n 


A PAGE I/O control func- 
tion .-;, with negative argu- 
ment was specified 


The PAGE command is 
ignored. 


L 


37 


ILLEGAL LINE COUNT ON CHANNEL n 


In a LINE I/O control 
function on an "unpaged" 
channel an argument less 
than the current line 
number was specified, or 
in the case of print mode 
a value areater than the 

number of lines per page 
was specified. 


In the first case the 
LINE function is 
ignored. In the 
second, the effect is 
PAGE (1) . 


L 


38 


ILLEGAL NUMERIC FIELD ON 
CHANNEL rt 


An invalid character was 
found while reading a 
numeric field (Valid 
characters: 0-9, -, +, ., 
E, B, H) 


The field with the 
invalid character (s) 
is skipped. The var- L 
iable remains unchanc ed 
as if a null _f ield 

were encountered. 


39 


ILLEGAL BIT OR CHARACTER STRING 


In READ mode, character/ 
bit strings must be 
delimited by apostrophes, 
with included apostrophes 
doubled . 


The field is treated 
as a numeric field 
with regard to sepa- 
rators, and is 
skipped. The charac- 
ter/bit variable re- 
mains unchanged as if 
a null field were 
encountered. 


L 
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Error 
Number 


- 

Message 


Explanation 


Standard Fixup 


SYSTEM 
Action 


" 40 
through 
49 


END OF FILE ON CHANNEL n 


Error 40+n is signalled 
if the end of file is 
reached while reading on 
channel n. 


The remainder of the 
1/0 statement is 
ignored. A further 
read on that channel 
will close and reope 
the file at line 1 

again. 


L 
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50 


ERROR IN HAL SOURCE 




Continue 


T 


51 


UNUSED 








52 


INACTIVE PROCESS IN UPDATE 
PRIORITY STATEMENT 


The specified task or 
program is not a 
currently scheduled 
process. 


The update request 
is ignored. 


& 


53 


INACTIVE PROCESS IN TERMINATE 
STATEMENT 


Same as above. 


The terminate 
request is ignored. 
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Error 
Number 


Message 


Explanation 


• Standard Fixup 


SYSTEM . 
Action 


54 


INACTIVE PROCESS IN CANCEL 

STATEMENT 


, Same as above. 


The cancel request 
is ignored. 


L 


55 


PROCESS ALREADY ACTIVE IN 
SCHEDULE STATEMENT 


The specified program 
or task is currently 
an active process 


The SCHEDULE 
statement is 

ignored. 


L 


56 


SUBSCRIPT OUT OF RANGE 


A variable has been sub- 
scripted by a value out- 
side the legal range of 
subscripts for that 
variable. 


None (IGNORE 

action not allowed) T 


57 


PROCESS NOT A DEPENDENT IN 
CANCEL STATEMENT 

! i 


The specified task or 
program is not depend- 
end on the running 
process . 


The cancel request 
is ignored. 


L 


58 


PROCESS NOT A DEPENDENT IN 
TERMINATE STATEMENT 


Same as above. 


The terminate* 
request is ignored. 

» 


L 



APPENDIX F. 



User Abend Codes -During Execution 



Missing DD card for message channel. 

The HAL/S channel specified for writing error and 
trace messages had no assigned DD card. {This may 
also appear as SYSTEM ABEND CODE 0) 

1 HAL/S error with SYSTEM=T. 

A run time error causing abnormal termination 
occurred. A specific message preceding the ABEND 
information explains the error. 

2 HAL/S error with SYSTEF=L and error count exceeded. 

A run time error occurred and the specified maximum 
error count for that error was thereby exceeded. 

3 Invalid error recursion. 

An error condition arose while processing a run time 
error. 

4 unused 

5 unused 

6 I/O mode conflict. 

Input asked for when I/O processor expected output or 
vice versa. 

7 Illegal I/O channel or mode. 

I/O asked for on illegal channel, or I/O mode was 

illegal. 

9 Program interrupt in non-HAL/S environment. 

Registers 12, 15 not set as expected on program 

inter ru o t . 



10 



Program interrupt from convert-to-binary (CVB) instruction 



11 Illegal HAL/S error number. 
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User Abend Codes During Compilation 

100 Unable to open one of the files: PROGRAM, SYSIN, OR 
SYSPRINT 

200 Unexpected end of file while reading in the XPL program 

300 Synad error while reading in the XPL program 

400 XPL program won't fit in the amount of memory available 

500 Invalid service code from the XPL program 

600 Printed-page limit exceeded 

700 Linked programs specified different size common areas 

800 Synad error on output file 

900 Invalid output file specified 

1000 Synad error on input file 

1100 Linking process overlayed common string area 

1200 End of file error on input file 

1300 Impossible to move the common strings up during linking 

1400 Invalid input file specified 

1500 Unknown request by 'MONITOR' func 

1600 Unknown do in 'MONITOR' request 

1700 Directory error on PDS 

1800 Synad error on output PDS file 

1900 Invalid member name specified 

2000 Synad error on direct access file 

2100 Attempt to read from an input PDS without issuing the 
"FIND" MONITOR request first 

2200 End of file error on direct access file 
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2300 Invalid member to be found 

2400 Synad error on PDS input file 

2500 File blocking specification err 

3000 MON#9/10 error or misaligned # 5 

4000 XPL program called exit to force an abend (and a possible 
core dump) 
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APPENDIX G 



List of names reserved for HAL/S programs only. 



AECCOS 

A ECS IN 

ARCTAN 

BAKTPACE 

CIN 

CINDEX 

CINP- 

CLJUST 

COLUMN 

COS 

COSH 

COT 

COUT 

C0U7P 

CPAS 

CPASP 

CEJUST 

CTOD 

CTOE 

CTOI 

CTBIM 

DARCCOS 

D ARCS IN 

DCOS 

DCOSH 

DCOT 

DEXP 

DIN 

DLOG 

Don? 

DSIN 

DSINH 

DSQRT 

DTAM 

DTOC" 

DTOTHBD 

DTOTHEl 

ETN 

EOUT 

ETOC 

ETOTU35 

.EToraEi 



EXP 

FLUSH 

GETSEED 

HALBUMP 

HALPRINT 

HAL ST ART 

HALSYS 

HDOPEN 

II BREAD 

HDWEITE 

HIN 

HSDTIHP 

TIN 

INP-TT 

IOIKII 

IOUT 

ITOC 

ITOTHSI 

LINE 

LOG 

MM6DN 

HH-6D3 

MM6SN 

MM6S3 

HOMSTACK 

MSGIOINT 

MV6DN 

MV6SN 

M1DNP, 

J11DSNP 

M1SDMP 

MtSNP 

M11DN 

M11SN 

M12DN 

M12D3 

M12SN 

*!1253 

M13DN 

^1 1 3 E 3 

M13SN 

B.13S3 

ft "Hi D 3 



M14SN 

M14S3 

K15DN 

M15SN 

M20DNP 

M20SNP 

H21DKP 

M21SNP 

OUTPUT 

PAGE 

PROGINT 

RANDOM 

EANDOMG 

SET SEED 

SIN 

SINH 

SKIP 

SKIPIN 

SKIPOUT 

SQRT 

STMTBACE 

TAB 

TAN 

TENSTBL 

VM6DN 

VM6SH 

V06DN 

V06D3 

V06SN 

V06S3 

VV6DN 

VV6SN 

V10DN 

V1CD3 

ViOSN 

V10S3 

V9DN 

V9D3 

V9SN 

V9S3 

WHERE 
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APPENDIX H. 



Compiler Directives 

The following compiler directives have been defined for the 

HAT./S-3 60 compiler. 

a) The DEVICE directive has the form: 

D DEVICE CHANNEL=n <option> 

This directive sets the mode of the specified channel 
(referred to via the CHANNELn DD card) to the mode 
indicated by the <option>. The <option> may be "PAGED", 
"UNPAGED", or null (in which case UNPAGED is assumed) . 

b) The INCLUDE directive has the form: 

D INCLUDE <name> <option> 

This directive names a member of an include library as 
defined in section 6.2.7. The <option> may be "NOLIST" or 
null. The "NOLIST" option indicates that the included 
text is not to be listed. 
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